@danmoisan/drm-copilot-mcp 1.1.18 → 1.1.19

package/resources/claude-customizations/.claude/lib/orchestrator-state/OrchestratorStateEpicWaveBarrier.psm1

@@ -0,0 +1,346 @@
+<#
+.SYNOPSIS
+    PowerShell port of the epic wave-barrier Layer 2 ordering check (issue #840).
+
+.DESCRIPTION
+    Ports validate_wave_barrier_ordering (scripts/dev_tools/_epic_orchestrator_state_wave_barrier.py)
+    as reached through validate_epic_orchestrator_state_text: feature extraction, the union
+    index with lifecycle-prefix normalization, the start guard, and the status and timing
+    checks with status-before-timing precedence. For in-parity inputs the violation strings
+    are byte-identical to the Python authority.
+
+    The checkpoint is parsed with System.Text.Json (JsonDocument), not ConvertFrom-Json:
+    ConvertFrom-Json coerces ISO-8601 strings to DateTime and reads property names
+    case-insensitively, and either behavior would break parity. Properties are read through
+    an ordinal, last-definition-wins enumeration, which matches Python json semantics for a
+    duplicate key.
+
+    An input this port does not evaluate fails closed with an error whose message starts
+    with EPIC_WAVE_BARRIER_UNEVALUABLE:. The declared divergence classes are listed in
+    tests/scripts/claude-lib/orchestrator-state/OrchestratorStateEpicWaveBarrier.Parity.Tests.ps1.
+
+.NOTES
+    PowerShell 7+. Reads no file and starts no process: the caller supplies checkpoint text
+    it has already read. Mirrored byte-identically into the bundled extension payload.
+    CONVENTION: this module fails fast at module scope and imports its siblings with -ErrorAction Stop.
+#>
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+# Lifecycle prefixes a folder hint may carry, tested in this order; the first match is stripped.
+$script:LifecyclePrefixes = @('docs/features/active/', 'docs/features/completed/', 'active/', 'completed/')
+
+# The merge statuses that durably confirm a dependency edge, and the literal not-started status.
+$script:MergedStatuses = @('merged', 'worktree_removed')
+$script:NotStartedStatus = 'not_started'
+
+# A JSON number token that Python reads as an int; any other number token is not compared.
+$script:IntegerTokenPattern = '^-?(0|[1-9][0-9]*)$'
+
+# The fail-closed token and the two violation formats of the Python authority.
+$script:UnevaluableToken = 'EPIC_WAVE_BARRIER_UNEVALUABLE:'
+$script:StatusViolationFormat = 'EPIC_WAVE_BARRIER_VIOLATION: {0} is treated as started while dependency {1} is not merged'
+$script:TimingViolationFormat = 'EPIC_WAVE_BARRIER_VIOLATION: {0} worktree_created_at precedes dependency {1} merge_confirmed_at'
+
+# Private: the last property of an object element whose name equals Name (ordinal), so a
+# duplicate key resolves the way Python json does. Found is $false when there is none.
+function Get-EpicWaveBarrierProperty {
+    [CmdletBinding()]
+    [OutputType([pscustomobject])]
+    param(
+        [Parameter(Mandatory = $true)] [System.Text.Json.JsonElement] $Element,
+        [Parameter(Mandatory = $true)] [string] $Name
+    )
+
+    $found = $false
+    $value = $null
+    foreach ($property in $Element.EnumerateObject()) {
+        if ([string]::Equals($property.Name, $Name, [System.StringComparison]::Ordinal)) {
+            $found = $true
+            $value = $property.Value
+        }
+    }
+    return [pscustomobject]@{ Found = $found; Value = $value }
+}
+
+# Private: the string value of a named property, or $null when it is absent or not a string.
+function Get-EpicWaveBarrierString {
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory = $true)] [System.Text.Json.JsonElement] $Element,
+        [Parameter(Mandatory = $true)] [string] $Name
+    )
+
+    $property = Get-EpicWaveBarrierProperty -Element $Element -Name $Name
+    if ($property.Found -and $property.Value.ValueKind -eq [System.Text.Json.JsonValueKind]::String) {
+        return $property.Value.GetString()
+    }
+    return $null
+}
+
+# Private: strip the first matching lifecycle prefix (ordinal), as _normalize_folder_hint does.
+function ConvertTo-EpicWaveBarrierFolderHint {
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $Value
+    )
+
+    foreach ($prefix in $script:LifecyclePrefixes) {
+        if ($Value.StartsWith($prefix, [System.StringComparison]::Ordinal)) {
+            return $Value.Substring($prefix.Length)
+        }
+    }
+    return $Value
+}
+
+# Private: the canonical decimal text of an integer token; BigInteger keeps values beyond
+# 64 bits exact and renders -0 as 0, as Python str(int) does.
+function ConvertTo-EpicWaveBarrierIntegerText {
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory = $true)] [string] $RawToken
+    )
+
+    $invariant = [System.Globalization.CultureInfo]::InvariantCulture
+    return [System.Numerics.BigInteger]::Parse($RawToken, $invariant).ToString($invariant)
+}
+
+# Private: the union-index key of a JSON number. Python indexes an int by value; a
+# non-integer token is outside parity, so it fails closed rather than being compared.
+function Get-EpicWaveBarrierNumberKey {
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory = $true)] [System.Text.Json.JsonElement] $Element,
+        [Parameter(Mandatory = $true)] [string] $Role,
+        [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $Folder
+    )
+
+    $raw = $Element.GetRawText()
+    if ($raw -cnotmatch $script:IntegerTokenPattern) {
+        throw ("{0} feature '{1}' has a non-integer numeric {2} token '{3}', which this port does not compare" -f
+            $script:UnevaluableToken, $Folder, $Role, $raw)
+    }
+    return 'n:' + (ConvertTo-EpicWaveBarrierIntegerText -RawToken $raw)
+}
+
+# Private: render a resolved dependency reference as Python str() renders the raw value.
+# Only strings, booleans, and integer numbers resolve, so no other kind reaches this point.
+function Format-EpicWaveBarrierReference {
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory = $true)] [System.Text.Json.JsonElement] $Element
+    )
+
+    $kind = $Element.ValueKind
+    if ($kind -eq [System.Text.Json.JsonValueKind]::String) { return $Element.GetString() }
+    if ($kind -eq [System.Text.Json.JsonValueKind]::True) { return 'True' }
+    if ($kind -eq [System.Text.Json.JsonValueKind]::False) { return 'False' }
+    return (ConvertTo-EpicWaveBarrierIntegerText -RawToken $Element.GetRawText())
+}
+
+# Private: the start guard of feature_has_started. A string worktree_created_at (empty
+# included) starts a feature; otherwise only the exact string not_started leaves it unstarted.
+function Test-EpicWaveBarrierFeatureStarted {
+    [CmdletBinding()]
+    [OutputType([bool])]
+    param(
+        [Parameter(Mandatory = $true)] [System.Text.Json.JsonElement] $Feature
+    )
+
+    if ($null -ne (Get-EpicWaveBarrierString -Element $Feature -Name 'worktree_created_at')) { return $true }
+    $status = Get-EpicWaveBarrierProperty -Element $Feature -Name 'merge_status'
+    if (-not $status.Found) { return $true }
+    $isNotStarted = ($status.Value.ValueKind -eq [System.Text.Json.JsonValueKind]::String) -and
+    [string]::Equals($status.Value.GetString(), $script:NotStartedStatus, [System.StringComparison]::Ordinal)
+    return (-not $isNotStarted)
+}
+
+# Private: whether a dependency's merge_status is a string equal (ordinal) to a merged status.
+# An absent or non-string status arrives as $null, which the [string] binding turns into an
+# empty string, and an empty string is not a merged status.
+function Test-EpicWaveBarrierMerged {
+    [CmdletBinding()]
+    [OutputType([bool])]
+    param(
+        [Parameter(Mandatory = $true)] [AllowNull()] [AllowEmptyString()] [string] $Status
+    )
+
+    foreach ($merged in $script:MergedStatuses) {
+        if ([string]::Equals($Status, $merged, [System.StringComparison]::Ordinal)) { return $true }
+    }
+    return $false
+}
+
+# Private: the union-index key of a feature's issue_num, or $null when it is absent, null,
+# or a string (a string issue_num is never matched by a non-string reference).
+function Get-EpicWaveBarrierIssueKey {
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory = $true)] [System.Text.Json.JsonElement] $Feature,
+        [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $Folder
+    )
+
+    $issue = Get-EpicWaveBarrierProperty -Element $Feature -Name 'issue_num'
+    if (-not $issue.Found) { return $null }
+    $kind = $issue.Value.ValueKind
+    # Routing table: an array or object cannot be hashed by the authority (fail closed);
+    # booleans key as 1 and 0 because Python treats True == 1; numbers key by value.
+    if ($kind -eq [System.Text.Json.JsonValueKind]::Array -or $kind -eq [System.Text.Json.JsonValueKind]::Object) {
+        throw ("{0} feature '{1}' has an issue_num that is an array or object, which the Python authority cannot index" -f
+            $script:UnevaluableToken, $Folder)
+    }
+    if ($kind -eq [System.Text.Json.JsonValueKind]::True) { return 'n:1' }
+    if ($kind -eq [System.Text.Json.JsonValueKind]::False) { return 'n:0' }
+    if ($kind -eq [System.Text.Json.JsonValueKind]::Number) {
+        return (Get-EpicWaveBarrierNumberKey -Element $issue.Value -Role 'issue_num' -Folder $Folder)
+    }
+    return $null
+}
+
+# Private: the object entries of a list-valued features property, in order; empty when the
+# root is not an object or features is absent or not a list.
+function Get-EpicWaveBarrierFeatureEntry {
+    [CmdletBinding()]
+    [OutputType([System.Text.Json.JsonElement[]], [object[]])]
+    param(
+        [Parameter(Mandatory = $true)] [System.Text.Json.JsonElement] $Root
+    )
+
+    $entries = [System.Collections.Generic.List[System.Text.Json.JsonElement]]::new()
+    if ($Root.ValueKind -ne [System.Text.Json.JsonValueKind]::Object) { return , $entries.ToArray() }
+    $features = Get-EpicWaveBarrierProperty -Element $Root -Name 'features'
+    if (-not $features.Found -or $features.Value.ValueKind -ne [System.Text.Json.JsonValueKind]::Array) {
+        return , $entries.ToArray()
+    }
+    # Keep only object-shaped entries, as _extract_features does.
+    foreach ($item in $features.Value.EnumerateArray()) {
+        if ($item.ValueKind -eq [System.Text.Json.JsonValueKind]::Object) { $entries.Add($item) }
+    }
+    return , $entries.ToArray()
+}
+
+# Private: resolve one depends_on element to a feature folder through the union index, or
+# $null. A string consults the folder hints only; a boolean or number consults issue_num only.
+function Resolve-EpicWaveBarrierReference {
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory = $true)] [System.Text.Json.JsonElement] $Dependency,
+        [Parameter(Mandatory = $true)] [System.Collections.Generic.Dictionary[string, string]] $ByHint,
+        [Parameter(Mandatory = $true)] [System.Collections.Generic.Dictionary[string, string]] $ByIssue,
+        [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $Folder
+    )
+
+    $kind = $Dependency.ValueKind
+    $key = $null
+    $map = $ByIssue
+    if ($kind -eq [System.Text.Json.JsonValueKind]::String) {
+        $key = ConvertTo-EpicWaveBarrierFolderHint -Value $Dependency.GetString()
+        $map = $ByHint
+    }
+    elseif ($kind -eq [System.Text.Json.JsonValueKind]::True) { $key = 'n:1' }
+    elseif ($kind -eq [System.Text.Json.JsonValueKind]::False) { $key = 'n:0' }
+    elseif ($kind -eq [System.Text.Json.JsonValueKind]::Number) {
+        $key = Get-EpicWaveBarrierNumberKey -Element $Dependency -Role 'depends_on reference' -Folder $Folder
+    }
+    if ($null -eq $key -or -not $map.ContainsKey($key)) { return $null }
+    return $map[$key]
+}
+
+# Private: the violation lines for the object entries, in feature and depends_on order.
+function Get-EpicWaveBarrierViolation {
+    [CmdletBinding()]
+    [OutputType([string])]
+    param(
+        [Parameter(Mandatory = $true)] [AllowEmptyCollection()] [System.Text.Json.JsonElement[]] $Entry
+    )
+
+    $ordinal = [System.StringComparer]::Ordinal
+    $byFolder = [System.Collections.Generic.Dictionary[string, System.Text.Json.JsonElement]]::new($ordinal)
+    $byHint = [System.Collections.Generic.Dictionary[string, string]]::new($ordinal)
+    $byIssue = [System.Collections.Generic.Dictionary[string, string]]::new($ordinal)
+
+    # Build the lookups: every string folder by name, and every non-empty string folder by
+    # its normalized hint and its issue_num. A later duplicate replaces an earlier one.
+    foreach ($feature in $Entry) {
+        $folder = Get-EpicWaveBarrierString -Element $feature -Name 'feature_folder'
+        if ($null -eq $folder) { continue }
+        $byFolder[$folder] = $feature
+        if ($folder.Length -eq 0) { continue }
+        $byHint[(ConvertTo-EpicWaveBarrierFolderHint -Value $folder)] = $folder
+        $issueKey = Get-EpicWaveBarrierIssueKey -Feature $feature -Folder $folder
+        if ($null -ne $issueKey) { $byIssue[$issueKey] = $folder }
+    }
+
+    # Check every started feature with a list depends_on; each edge yields at most one line,
+    # and the status violation takes precedence over the timing violation.
+    foreach ($feature in $Entry) {
+        $folder = Get-EpicWaveBarrierString -Element $feature -Name 'feature_folder'
+        $dependsOn = Get-EpicWaveBarrierProperty -Element $feature -Name 'depends_on'
+        if ($null -eq $folder -or -not $dependsOn.Found -or $dependsOn.Value.ValueKind -ne [System.Text.Json.JsonValueKind]::Array) { continue }
+        if (-not (Test-EpicWaveBarrierFeatureStarted -Feature $feature)) { continue }
+        $created = Get-EpicWaveBarrierString -Element $feature -Name 'worktree_created_at'
+        foreach ($dependency in $dependsOn.Value.EnumerateArray()) {
+            $resolved = Resolve-EpicWaveBarrierReference -Dependency $dependency -ByHint $byHint -ByIssue $byIssue -Folder $folder
+            if ($null -eq $resolved -or -not $byFolder.ContainsKey($resolved)) { continue }
+            $target = $byFolder[$resolved]
+            $reference = Format-EpicWaveBarrierReference -Element $dependency
+            if (-not (Test-EpicWaveBarrierMerged -Status (Get-EpicWaveBarrierString -Element $target -Name 'merge_status'))) {
+                $script:StatusViolationFormat -f $folder, $reference
+                continue
+            }
+            $confirmed = Get-EpicWaveBarrierString -Element $target -Name 'merge_confirmed_at'
+            if ($null -ne $confirmed -and $null -ne $created -and [string]::CompareOrdinal($confirmed, $created) -gt 0) {
+                $script:TimingViolationFormat -f $folder, $reference
+            }
+        }
+    }
+}
+
+function Get-OrchestratorStateEpicWaveBarrierError {
+    <#
+    .SYNOPSIS
+        Return the EPIC_WAVE_BARRIER_VIOLATION lines for an epic checkpoint's text.
+    .DESCRIPTION
+        Parses the text with System.Text.Json default options and applies the Layer 2
+        ordering check. Returns an empty array when there is no violation, when the root is
+        not an object, or when features is absent or not a list. Throws an error whose
+        message starts with EPIC_WAVE_BARRIER_UNEVALUABLE: for text System.Text.Json does
+        not parse (including NaN or Infinity literals and nesting deeper than 64 levels), an
+        array or object issue_num, and a non-integer number token that the check consults.
+    .PARAMETER CheckpointText
+        The raw epic checkpoint JSON text.
+    .OUTPUTS
+        System.String[]
+    #>
+    [CmdletBinding()]
+    [OutputType([string[]], [object[]])]
+    param(
+        [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $CheckpointText
+    )
+
+    $document = $null
+    try {
+        $document = [System.Text.Json.JsonDocument]::Parse($CheckpointText, [System.Text.Json.JsonDocumentOptions]::new())
+    }
+    catch {
+        throw ('{0} the checkpoint is not parseable by System.Text.Json with default options (a non-standard literal such as NaN or Infinity, or nesting deeper than 64 levels): {1}' -f
+            $script:UnevaluableToken, $_.Exception.Message)
+    }
+    try {
+        $entries = Get-EpicWaveBarrierFeatureEntry -Root $document.RootElement
+        return , [string[]] @(Get-EpicWaveBarrierViolation -Entry $entries)
+    }
+    finally {
+        $document.Dispose()
+    }
+}
+
+Export-ModuleMember -Function Get-OrchestratorStateEpicWaveBarrierError

package/resources/claude-customizations/.claude/lib/orchestrator-state/OrchestratorStateIssueAdoption.psm1

@@ -43,6 +43,8 @@ $script:WAIVABLE_TOOLS = [string[]]@($script:POTENTIAL_TO_ISSUE_TOOL, $script:FE
 $script:PROMOTION_ENTRY_TOOLS = [string[]]@($script:FEATURE_PROMOTION_ENTRY_TOOL, $script:BUG_PROMOTION_ENTRY_TOOL)
 $script:POTENTIAL_RECORD_PREFIX = 'docs/features/potential/'
 $script:POTENTIAL_RECORD_SUFFIX = '.md'
+# Origins whose promotion-entry waiver may omit the potential_record key (rule 9).
+$script:RECORD_OPTIONAL_ORIGINS = [string[]]@('transferred', 'filed_before_orchestration')
 $script:ISSUE_NUM_PATTERN = '\A[1-9][0-9]*\z'
 
 $script:ERROR_NOT_OBJECT = 'Checkpoint issue_adoption must be an object when present.'
@@ -264,6 +266,13 @@ function Get-AdoptionPotentialRecordError {
         The well-formed waived tool list, in checkpoint order.
     .PARAMETER PotentialRecord
         The deserialized potential_record value. May be $null.
+    .PARAMETER Origin
+        The deserialized origin value. May be $null. When the potential_record
+        key is absent and the origin is transferred or filed_before_orchestration,
+        nothing is reported.
+    .PARAMETER RecordPresent
+        Whether the potential_record key is present. A present record, including
+        $null, is always validated.
     .OUTPUTS
         System.String[] - zero or more error strings.
     #>
@@ -275,9 +284,20 @@ function Get-AdoptionPotentialRecordError {
 
         [Parameter(Mandatory = $true)]
         [AllowNull()]
-        [object] $PotentialRecord
+        [object] $PotentialRecord,
+
+        [Parameter()]
+        [AllowNull()]
+        [object] $Origin,
+
+        [Parameter(Mandatory = $true)]
+        [bool] $RecordPresent
     )
 
+    if (-not $RecordPresent -and ($Origin -is [string]) -and ($script:RECORD_OPTIONAL_ORIGINS -ccontains [string]$Origin)) {
+        return [string[]]@()
+    }
+
     $recordIsValid = $false
     if ($PotentialRecord -is [string]) {
         $record = [string]$PotentialRecord
@@ -356,8 +376,9 @@ function Get-OrchestratorStateIssueAdoptionResult {
     }
 
     $errors.AddRange([string[]]@(Get-AdoptionWaivedToolError -WaivedTool $waived.Value -RouteId $RouteId -RequiredMcpTool $RequiredMcpTool -SuccessfulTool $SuccessfulTool))
-    $potentialRecord = (Get-CheckpointObjectMember -Owner $adoption -Name 'potential_record').Value
-    $errors.AddRange([string[]]@(Get-AdoptionPotentialRecordError -WaivedTool $waived.Value -PotentialRecord $potentialRecord))
+    $recordMember = Get-CheckpointObjectMember -Owner $adoption -Name 'potential_record'
+    $origin = (Get-CheckpointObjectMember -Owner $adoption -Name 'origin').Value
+    $errors.AddRange([string[]]@(Get-AdoptionPotentialRecordError -WaivedTool $waived.Value -PotentialRecord $recordMember.Value -Origin $origin -RecordPresent $recordMember.Present))
 
     if ($errors.Count -gt 0) {
         return @{ Errors = $errors.ToArray(); WaivedTools = [string[]]@() }

package/resources/claude-customizations/.claude/lib/worktree-resolution/WorktreeItemResolution.psm1

@@ -21,7 +21,8 @@
     PowerShell 7+. Re-uses its siblings for enumeration, the marker test, the ascent,
     the branch reader, normalisation, the join, the result constructor, and both
     reason-code accessors, re-implementing none. Neither reason-code literal appears
-    here. Its only filesystem read is the checkpoint-text seam. Mirrored byte-identically.
+    here. Its only filesystem read is still the checkpoint-text seam, including for the
+    item-by-pull-request resolver added for issue #850. Mirrored byte-identically.
     CONVENTION: this module fails fast at module scope and imports its siblings with -ErrorAction Stop.
 #>
 
@@ -395,6 +396,81 @@ function Resolve-WorktreeItemTarget {
     return (Resolve-WorktreeItemTargetByIssue -Session $session -Issue $issues[0])
 }
 
+# Private: whether checkpoint text records a pull request number in pr_gate.pr_number or
+# in a standalone_merge_authorizations entry whose pr_number is a positive JSON integer.
+function Test-WorktreeItemCheckpointRecordsPr {
+    [CmdletBinding()]
+    [OutputType([bool])]
+    param(
+        [Parameter(Mandatory = $true)] [AllowNull()] [AllowEmptyString()] [string] $Text,
+        [Parameter(Mandatory = $true)] [long] $PrNumber
+    )
+
+    if ([string]::IsNullOrWhiteSpace($Text)) { return $false }
+    $payload = $null
+    try { $payload = $Text | ConvertFrom-Json } catch { return $false }
+    if ($null -eq $payload -or $payload -isnot [pscustomobject]) { return $false }
+    # Names are collected per property, because strict mode throws on .Name of an empty object.
+    $names = @($payload.PSObject.Properties | ForEach-Object { $_.Name })
+    if ($names -contains 'pr_gate' -and $payload.pr_gate -is [pscustomobject] -and @($payload.pr_gate.PSObject.Properties | ForEach-Object { $_.Name }) -contains 'pr_number') {
+        $recorded = [long] 0
+        if ([long]::TryParse([string] $payload.pr_gate.pr_number, [ref] $recorded) -and $recorded -eq $PrNumber) { return $true }
+    }
+    if ($names -notcontains 'standalone_merge_authorizations') { return $false }
+    foreach ($entry in @($payload.standalone_merge_authorizations)) {
+        if ($entry -isnot [pscustomobject] -or @($entry.PSObject.Properties | ForEach-Object { $_.Name }) -notcontains 'pr_number') { continue }
+        $value = $entry.pr_number
+        # Only a JSON integer counts; a string, fraction, zero, or negative never matches.
+        if (($value -is [int] -or $value -is [long]) -and $value -gt 0 -and [long] $value -eq $PrNumber) { return $true }
+    }
+    return $false
+}
+
+function Resolve-WorktreeItemTargetByPrNumber {
+    <#
+    .SYNOPSIS
+        Resolve the live worktree whose orchestrator checkpoint records a pull request number (issue #850).
+    .DESCRIPTION
+        Keeps each live root whose checkpoint records the number in pr_gate.pr_number or
+        in a standalone_merge_authorizations entry. Zero matches resolve NoTarget, one
+        resolves, and several are Ambiguous with no tie-break. A number of zero or less
+        is NoTarget. Reads only through the checkpoint-text seam.
+    .PARAMETER PrNumber
+        The pull request number the command names.
+    .PARAMETER SessionRoot
+        The calling process's path, used only to find the repository and label a result.
+        Defaults to the current location when blank.
+    #>
+    [CmdletBinding()]
+    [OutputType([pscustomobject])]
+    param(
+        [Parameter(Mandatory = $true)] [long] $PrNumber,
+        [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $SessionRoot
+    )
+
+    $session = if ([string]::IsNullOrWhiteSpace($SessionRoot)) { (Get-Location).ProviderPath } else { $SessionRoot }
+    $noTarget = "pull request {0} is recorded in pr_gate.pr_number or a standalone_merge_authorizations entry of no live worktree's orchestrator checkpoint" -f $PrNumber
+    if ($PrNumber -le 0) {
+        return (New-WorktreeResolutionTargetResult -Status 'NoTarget' -SessionRoot $session -Detail $noTarget)
+    }
+    # Assigned before it is wrapped, for the reason recorded in the branch resolver.
+    $liveRoots = Get-WorktreeItemLiveRoot -SessionRoot $session
+    $matched = [System.Collections.Generic.List[string]]::new()
+    foreach ($root in @($liveRoots)) {
+        $text = Get-WorktreeItemCheckpointText -Path (Get-WorktreeItemCheckpointPath -WorktreeRoot $root)
+        if (Test-WorktreeItemCheckpointRecordsPr -Text $text -PrNumber $PrNumber) { $matched.Add($root) }
+    }
+    if ($matched.Count -eq 0) {
+        return (New-WorktreeResolutionTargetResult -Status 'NoTarget' -SessionRoot $session -Detail $noTarget)
+    }
+    if ($matched.Count -eq 1) {
+        return (ConvertTo-WorktreeItemResolvedResult -WorktreeRoot $matched[0] -SessionRoot $session -Detail (
+                "pull request {0} resolves to the live worktree whose orchestrator checkpoint records it" -f $PrNumber))
+    }
+    return (New-WorktreeResolutionTargetResult -Status 'Ambiguous' -SessionRoot $session -Candidate $matched.ToArray() -Detail (
+            "pull request {0} is recorded in the orchestrator checkpoints of {1} live worktrees; move the stale checkpoint to artifacts/orchestration/handoff/ so that one worktree records it" -f $PrNumber, $matched.Count))
+}
+
 Export-ModuleMember -Function `
     Get-WorktreeItemCheckpointRelativePath, `
     Get-WorktreeItemCheckpointPath, `
@@ -404,4 +480,5 @@ Export-ModuleMember -Function `
     Get-WorktreeItemCheckpointIssue, `
     Get-WorktreeItemLiveRoot, `
     ConvertTo-WorktreeItemResolvedResult, `
-    Resolve-WorktreeItemTarget
+    Resolve-WorktreeItemTarget, `
+    Resolve-WorktreeItemTargetByPrNumber

package/resources/claude-customizations/.claude/lib/worktree-resolution/WorktreeRunResolution.psm1

@@ -340,7 +340,7 @@ function Resolve-WorktreeParallelTarget {
 }
 
 # Private: compare two worktree paths, insensitive to separator style and trailing
-# slashes, and case-insensitive only for drive-letter paths.
+# slashes, and case-insensitive for drive-letter and UNC (//) paths.
 function Test-WorktreeRunPathEqual {
     [CmdletBinding()]
     [OutputType([bool])]
@@ -352,8 +352,8 @@ function Test-WorktreeRunPathEqual {
     if ([string]::IsNullOrWhiteSpace($Left) -or [string]::IsNullOrWhiteSpace($Right)) { return $false }
     $a = ($Left.Trim() -replace '\\', '/').TrimEnd('/')
     $b = ($Right.Trim() -replace '\\', '/').TrimEnd('/')
-    $isDrivePath = ($a -match '^[A-Za-z]:') -or ($b -match '^[A-Za-z]:')
-    $comparison = if ($isDrivePath) { [System.StringComparison]::OrdinalIgnoreCase } else { [System.StringComparison]::Ordinal }
+    $isCaseInsensitivePath = ($a -match '^([A-Za-z]:|//)') -or ($b -match '^([A-Za-z]:|//)')
+    $comparison = if ($isCaseInsensitivePath) { [System.StringComparison]::OrdinalIgnoreCase } else { [System.StringComparison]::Ordinal }
     return [string]::Equals($a, $b, $comparison)
 }
 

package/resources/claude-customizations/.claude/rules/architecture-boundaries.md

@@ -2,7 +2,7 @@
 paths:
   - "**/*.ts"
   - "**/*.cs"
-description: Architecture boundary enforcement rules for the No-COM architecture.
+description: Architecture boundary enforcement rules for a host-neutral layered architecture.
 ---
 
 # Architecture Boundaries
@@ -14,7 +14,7 @@ Architecture boundary enforcement is a uniform gate across all tiers (T1–T4).
 - **TypeScript:** `dependency-cruiser`. Configuration file pattern: `.dependency-cruiser.cjs`.
 - **.NET (when the backend exists):** `NetArchTest.Rules`. Test project naming pattern: `*.ArchitectureTests`.
 
-## No-COM Architecture Rules (enforceable assertions)
+## Host-Neutral Architecture Rules (enforceable assertions)
 
 Production code in this repository must satisfy each of the following assertions. Each assertion is enforced by `dependency-cruiser` (TypeScript) or `NetArchTest.Rules` (.NET) where applicable; legacy import utilities, when added, must satisfy the same assertions.
 
@@ -37,9 +37,9 @@ Production code in this repository must satisfy each of the following assertions
 
 ## Layer Boundary Assertions (.NET, applies once the backend exists)
 
-- `TaskMaster.Domain` must have zero references to Outlook PIA, VSTO, or Office.js types.
-- `TaskMaster.Application` may depend on `TaskMaster.Domain` only.
-- Adapter projects may depend on `TaskMaster.Domain` and `TaskMaster.Application`; domain may not depend on adapters.
+- `<Product>.Domain` must have zero references to Outlook PIA, VSTO, or Office.js types.
+- `<Product>.Application` may depend on `<Product>.Domain` only.
+- Adapter projects may depend on `<Product>.Domain` and `<Product>.Application`; domain may not depend on adapters.
 
 ## Enforcement Outcome
 

package/resources/claude-customizations/.claude/rules/csharp.md

@@ -2,12 +2,12 @@
 paths:
   - "**/*.cs"
   - "**/*.csproj"
-description: C#-specific toolchain and coding standards (No-COM, xUnit).
+description: C#-specific toolchain and coding standards (xUnit).
 ---
 
 # C# Code Standards
 
-This rule file summarizes the C#-specific policies for this repository. It targets the No-COM .NET foundation: xUnit, NSubstitute, FluentAssertions, `dotnet build`, the analyzer stack, `TimeProvider`, and uniform coverage thresholds.
+This rule file summarizes the C#-specific policies for this repository. It targets a host-neutral .NET foundation: xUnit, NSubstitute, FluentAssertions, `dotnet build`, the analyzer stack, `TimeProvider`, and uniform coverage thresholds.
 
 ## Toolchain
 

package/resources/claude-customizations/.claude/rules/general-code-change.md

@@ -26,7 +26,7 @@ Apply these priorities in order when designing or changing code:
 
 ## Module Rigor Tiers
 
-Module rigor tiers (T1–T4) and the uniform-versus-tier-dependent gate matrix are defined in `.claude/rules/quality-tiers.md`. Every project must be classified in `quality-tiers.yml` at repo root.
+Module rigor tiers (T1–T4) and the uniform-versus-tier-dependent gate matrix are defined in `.claude/rules/quality-tiers.md` and apply only when `quality-tiers.yml` exists at the repository root; in that case every project must be classified in it. A repository without `quality-tiers.yml` has not adopted tiers, and the tier requirements do not apply.
 
 ## Mandatory Toolchain Loop
 

package/resources/claude-customizations/.claude/rules/general-unit-test.md

@@ -20,10 +20,11 @@ Every unit test must satisfy all five of these properties:
 
 ## Coverage Requirements
 
+- Threshold precedence: when the repository's root `CLAUDE.md` states line or branch coverage thresholds, those thresholds govern. The 85% line and 75% branch figures are defaults that apply only when the root `CLAUDE.md` states none. This precedence applies to every restatement of these figures in other rule files, agents, and skills. Each metric falls back independently: when the root `CLAUDE.md` states only a line threshold or only a branch threshold, the stated threshold governs that metric and the default governs the other.
 - **Line coverage must remain >= 85% across all tiers (T1–T4).**
 - **Branch coverage must remain >= 75% across all tiers (T1–T4) for languages whose coverage tooling measures branch coverage.** PowerShell (Pester) and bash (kcov) are the exceptions: neither tool measures branch coverage in any output format, so only the line threshold applies to them and there is no branch-coverage gate. This is a threshold exemption only; PowerShell and bash production files remain in the coverage denominator under the Coverage Exclusion Policy below.
 - Code changes or refactors must not reduce coverage for the lines that were changed.
-- Tier-specific lower coverage thresholds are not used in this repository. See `.claude/rules/quality-tiers.md` for the full tier system.
+- Tier-specific lower coverage thresholds are not used. See `.claude/rules/quality-tiers.md` for the full tier system, which applies only when `quality-tiers.yml` exists at the repository root.
 - Coverage is a supporting metric, not the sole quality gate. Untested critical behavior is not acceptable even if the overall percentage looks good.
 - Configure coverage tooling to exclude test files (e.g., `tests/`) so metrics reflect application code, not tests.
 - Type-only / interface-only modules with no executable behavior may be omitted from coverage measurement. Examples: Python `Protocol`-only modules consumed only under `TYPE_CHECKING`, TypeScript interface/type-only files, and C# interface-only files. Such modules legitimately report 0% executable coverage and may be excluded from measurement. This is a clarification only; it does not lower any coverage threshold.
@@ -86,7 +87,7 @@ Colocation — placing test files alongside production source files in `src/` or
 
 ## Test Categories
 
-The following test categories apply across the repository, with tier-dependent obligations per `.claude/rules/quality-tiers.md`:
+The following test categories apply across the repository, with tier-dependent obligations per `.claude/rules/quality-tiers.md`; those tier-dependent obligations apply only when `quality-tiers.yml` exists at the repository root:
 
 - **Unit tests** — required for all tiers (T1–T4). Cover single units of behavior in isolation.
 - **Property-based tests** — required for T1 and T2 modules: at least one property test per pure function. Use `fast-check` (TypeScript) or `hypothesis` (Python) where applicable.