CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/intent-integrity-kit

Closing the intent-to-code chasm - specification-driven development with BDD verification chain

Overall
score

96%

Review — 96%

Does it follow best practices?

Validation — 132 / 132 Passed

Validation for skill structure

Overview
Skills
Evals
Files

post-commit-hook.ps1skills/iikit-core/scripts/powershell/

#!/usr/bin/env pwsh

IIKIT-POST-COMMIT

Git post-commit hook for tamper-resistant assertion hash storage (PowerShell)

Stores assertion hashes as git notes when test-specs.md is committed

This script provides PowerShell parity for CI or direct PowerShell invocation.

The actual .git/hooks/post-commit is always bash (git invokes hooks via sh).

Usage: pwsh post-commit-hook.ps1

$ErrorActionPreference = "Stop"

============================================================================

PATH DETECTION — find the scripts directory at runtime

============================================================================

try { $repoRoot = (git rev-parse --show-toplevel 2>$null) if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrEmpty($repoRoot)) { exit 0 } } catch { exit 0 }

$scriptsDir = $null $candidatePaths = @( (Join-Path $repoRoot ".claude/skills/iikit-core/scripts/powershell"), (Join-Path $repoRoot ".tessl/tiles/tessl-labs/intent-integrity-kit/skills/iikit-core/scripts/powershell"), (Join-Path $repoRoot ".codex/skills/iikit-core/scripts/powershell") )

foreach ($candidate in $candidatePaths) { if (Test-Path (Join-Path $candidate "testify-tdd.ps1")) { $scriptsDir = $candidate break } }

if (-not $scriptsDir) { exit 0 }

$testifyScript = Join-Path $scriptsDir "testify-tdd.ps1"

============================================================================

FAST PATH — exit if no .feature files or test-specs.md in the commit

============================================================================

$committedFiles = git diff-tree --no-commit-id --name-only -r HEAD 2>$null $committedFeatureFiles = $committedFiles | Where-Object { $_ -match 'tests/features/.*.feature$' } $committedTestSpecs = $committedFiles | Where-Object { $_ -match 'test-specs.md$' }

if (-not $committedFeatureFiles -and -not $committedTestSpecs) { exit 0 }

============================================================================

STORE GIT NOTES — for each committed test-specs.md

============================================================================

Preserve any existing note content (from a previous testify on this commit)

$existingNote = "" try { $existingNote = git notes --ref="refs/notes/testify" show HEAD 2>$null if ($LASTEXITCODE -ne 0) { $existingNote = "" } } catch { $existingNote = "" } $fullNote = $existingNote

--- .feature files: group by feature directory, compute combined hash ---

if ($committedFeatureFiles) { $committedFeatDirs = @{} foreach ($committedPath in $committedFeatureFiles) { if ([string]::IsNullOrEmpty($committedPath)) { continue } $featuresDir = Split-Path $committedPath -Parent # tests/features $testsDir = Split-Path $featuresDir -Parent # tests $featDir = Split-Path $testsDir -Parent # specs/NNN-feature $committedFeatDirs[$featDir] = $true }

foreach ($featDir in $committedFeatDirs.Keys) {
    # Extract all committed .feature files for this feature to temp dir
    $tempFeaturesDir = Join-Path ([System.IO.Path]::GetTempPath()) ([System.IO.Path]::GetRandomFileName())
    New-Item -ItemType Directory -Path $tempFeaturesDir -Force | Out-Null

    $featFiles = $committedFeatureFiles | Where-Object { $_ -match "^$([regex]::Escape($featDir))/" }
    foreach ($cf in $featFiles) {
        if ([string]::IsNullOrEmpty($cf)) { continue }
        $basename = Split-Path $cf -Leaf
        try {
            $content = git show "HEAD:$cf" 2>$null
            if ($LASTEXITCODE -eq 0 -and -not [string]::IsNullOrEmpty($content)) {
                $content | Out-File -FilePath (Join-Path $tempFeaturesDir $basename) -Encoding utf8
            }
        } catch { continue }
    }

    $currentHash = & $testifyScript compute-hash $tempFeaturesDir
    Remove-Item -Recurse -Force $tempFeaturesDir -ErrorAction SilentlyContinue

    if ($currentHash -eq "NO_ASSERTIONS") {
        continue
    }

    $timestamp = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
    $featuresRelPath = "$featDir/tests/features"
    $entry = "testify-hash: $currentHash`ngenerated-at: $timestamp`nfeatures-dir: $featuresRelPath"

    # Remove any existing entry for this features dir
    if (-not [string]::IsNullOrEmpty($fullNote)) {
        $lines = $fullNote -split "`n"
        $filtered = @()
        $skip = $false
        $currentBlock = @()
        foreach ($line in $lines) {
            if ($line -match '^testify-hash:') {
                if ($currentBlock.Count -gt 0 -and -not $skip) {
                    $filtered += $currentBlock
                }
                $currentBlock = @($line)
                $skip = $false
            } elseif ($line -eq '---') {
                if (-not $skip) {
                    $currentBlock += $line
                    $filtered += $currentBlock
                }
                $currentBlock = @()
                $skip = $false
            } else {
                if ($line -match "^features-dir:.*$([regex]::Escape($featuresRelPath))") {
                    $skip = $true
                }
                $currentBlock += $line
            }
        }
        if ($currentBlock.Count -gt 0 -and -not $skip) {
            $filtered += $currentBlock
        }
        $fullNote = ($filtered -join "`n").Trim()
    }

    # Append new entry
    if (-not [string]::IsNullOrEmpty($fullNote)) {
        $fullNote = "$fullNote`n---`n$entry"
    } else {
        $fullNote = $entry
    }

    Write-Host "[iikit] Assertion hash stored as git note for $featuresRelPath" -ForegroundColor Green
}

}

--- Legacy test-specs.md files ---

foreach ($committedPath in $committedTestSpecs) { if ([string]::IsNullOrEmpty($committedPath)) { continue }

# Get the committed version from HEAD
$tempFile = [System.IO.Path]::GetTempFileName()
try {
    $committedContent = git show "HEAD:$committedPath" 2>$null
    if ($LASTEXITCODE -ne 0 -or [string]::IsNullOrEmpty($committedContent)) {
        Remove-Item $tempFile -ErrorAction SilentlyContinue
        continue
    }
    $committedContent | Out-File -FilePath $tempFile -Encoding utf8
} catch {
    Remove-Item $tempFile -ErrorAction SilentlyContinue
    continue
}

# Compute hash of the committed version
$currentHash = & $testifyScript compute-hash $tempFile
Remove-Item $tempFile -ErrorAction SilentlyContinue

# Skip if no assertions
if ($currentHash -eq "NO_ASSERTIONS") {
    continue
}

$timestamp = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
$entry = "testify-hash: $currentHash`ngenerated-at: $timestamp`ntest-specs-file: $committedPath"

# Remove any existing entry for this same file
if (-not [string]::IsNullOrEmpty($fullNote)) {
    $lines = $fullNote -split "`n"
    $filtered = @()
    $skip = $false
    $currentBlock = @()
    foreach ($line in $lines) {
        if ($line -match '^testify-hash:') {
            if ($currentBlock.Count -gt 0 -and -not $skip) {
                $filtered += $currentBlock
            }
            $currentBlock = @($line)
            $skip = $false
        } elseif ($line -eq '---') {
            if (-not $skip) {
                $currentBlock += $line
                $filtered += $currentBlock
            }
            $currentBlock = @()
            $skip = $false
        } else {
            if ($line -match "^test-specs-file:.*$([regex]::Escape($committedPath))") {
                $skip = $true
            }
            $currentBlock += $line
        }
    }
    if ($currentBlock.Count -gt 0 -and -not $skip) {
        $filtered += $currentBlock
    }
    $fullNote = ($filtered -join "`n").Trim()
}

# Append new entry
if (-not [string]::IsNullOrEmpty($fullNote)) {
    $fullNote = "$fullNote`n---`n$entry"
} else {
    $fullNote = $entry
}

Write-Host "[iikit] Assertion hash stored as git note for $committedPath" -ForegroundColor Green

}

Write the accumulated note

if (-not [string]::IsNullOrEmpty($fullNote)) { try { $fullNote | git notes --ref="refs/notes/testify" add -f -F - HEAD 2>$null } catch { # Git notes failed — not critical, continue } }

exit 0

Install with Tessl CLI

npx tessl i tessl-labs/intent-integrity-kit

skills

iikit-core

scripts

powershell

bugfix-helpers.ps1

check-prerequisites.ps1

common.ps1

create-new-feature.ps1

fetch-tile-evals.ps1

generate-dashboard-safe.ps1

git-setup.ps1

init-project.ps1

post-commit-hook.ps1

pre-commit-hook.ps1

set-active-feature.ps1

setup-bdd.ps1

setup-plan.ps1

setup-windows-links.ps1

testify-tdd.ps1

update-agent-context.ps1

validate-premise.ps1

verify-step-quality.ps1

verify-steps.ps1

verify-test-execution.ps1

SKILL.md

README.md

tile.json