Dev docs organized for run

[pashute]

• readme.md

• /dev/docs/binabase.background.md

• /dev/docs/devplan.md:

  • general instructions
  • initial framework

• future iterations

• AI instructions - add cmd usage

  • commit and push
  • close projman item

[pashute]

Instructions comment:

• AI instructions - add cmd usage:

  • commit and push
  • close Projman item

• Discuss with AI how to let ai do everything with these utilities taking from the user's instruction and previous Projman item and commits.

• See that each Powershell cmd report also includes Success notification to user that includes:
  Branch-name,, item number, name and link to url (if subissue then also parent num and name with link to url), iteration name,

• each powershell cmd shows the message it is going to use for commit/push/item-closure.

• user should manually install vs-studio powershell extension (or is it windsurf extension/both?) since it failed automatically

• test the process with the user to see if works correctly.

--- text of the current utility commands
== commit and push ==
param(
[Parameter(Mandatory=$true)]
[int]$IssueNumber,

[Parameter(Mandatory=$false)]
[string]$IssueTitle = "",

[Parameter(Mandatory=$false)]
[switch]$Review = $false,

[Parameter(Mandatory=$false)]
[switch]$Execute = $false

)

Get git status

$status = git status --short
$changedFiles = git diff --name-only
$stagedFiles = git diff --cached --name-only

Fetch issue details if title not provided

if (-not $IssueTitle) {
$issueJson = gh issue view $IssueNumber --repo pashute/binabase --json title
$issueObj = $issueJson | ConvertFrom-Json
$IssueTitle = $issueObj.title
}

$issueLink = "https://github.com/pashute/binabase/issues/$IssueNumber"

Build commit message

$filesList = $stagedFiles -join ", "
if (-not $filesList) {
$filesList = $changedFiles -join ", "
}
$commitMessage = "#$IssueNumber $IssueTitle $issueLink | $filesList"

Review mode

if ($Review) {
Write-Host "=== REVIEW MODE ===" -ForegroundColor Cyan
Write-Host ""
Write-Host "Issue: #$IssueNumber $IssueTitle" -ForegroundColor Yellow
Write-Host "Link: $issueLink" -ForegroundColor Yellow
Write-Host ""
Write-Host "Files changed (staged):" -ForegroundColor Green
if ($stagedFiles) {
$stagedFiles | ForEach-Object { Write-Host " - $" }
} else {
Write-Host " (none staged)" -ForegroundColor Red
}
Write-Host ""
Write-Host "Files changed (unstaged):" -ForegroundColor Green
if ($changedFiles) {
$changedFiles | ForEach-Object { Write-Host " - $" }
} else {
Write-Host " (none unstaged)" -ForegroundColor Gray
}
Write-Host ""
Write-Host "Proposed commit message:" -ForegroundColor Green
Write-Host " $commitMessage" -ForegroundColor White
Write-Host ""
Write-Host "Ask AI to review this output before running with -Execute" -ForegroundColor Yellow
exit 0
}

Execute mode

if ($Execute) {
Write-Host "=== EXECUTING ===" -ForegroundColor Cyan
Write-Host "Commit message: $commitMessage" -ForegroundColor Yellow

# Stage all changes if nothing staged
if (-not $stagedFiles) {
    Write-Host "Staging all changes..." -ForegroundColor Gray
    git add -A
}

# Commit
git commit -m $commitMessage
if ($LASTEXITCODE -ne 0) {
    Write-Host "Commit failed!" -ForegroundColor Red
    exit 1
}

# Push
Write-Host "Pushing to origin..." -ForegroundColor Gray
git push
if ($LASTEXITCODE -ne 0) {
    Write-Host "Push failed! Try: git push --set-upstream origin $(git branch --show-current)" -ForegroundColor Red
    exit 1
}

Write-Host "Commit and push complete!" -ForegroundColor Green
exit 0

}

Default: show usage

Write-Host "Usage:" -ForegroundColor Cyan
Write-Host " .\commitAndPush.ps1 -IssueNumber <#> -Review # Review before committing"
Write-Host " .\commitAndPush.ps1 -IssueNumber <#> -Execute # Execute commit and push"
Write-Host " .\commitAndPush.ps1 -IssueNumber <#> -IssueTitle <title> -Execute"

==== close projman item ====
param(
[Parameter(Mandatory=$true)]
[int]$IssueNumber,

[Parameter(Mandatory=$false)]
[string]$IssueTitle = "",

[Parameter(Mandatory=$false)]
[switch]$Review = $false,

[Parameter(Mandatory=$false)]
[switch]$Execute = $false

)

Get issue details

$issueJson = gh issue view $IssueNumber --repo pashute/binabase --json title,body,state,labels
$issueObj = $issueJson | ConvertFrom-Json

if (-not $IssueTitle) {
$IssueTitle = $issueObj.title
}

$issueLink = "https://github.com/pashute/binabase/issues/$IssueNumber"

Get commits for this issue (from current branch)

$commits = git log --all --grep="#$IssueNumber" --oneline
if (-not $commits) {
$commits = git log --oneline -10
}

Build close comment

$closeComment = @"
Completed. Documentation reorganized:

• README.md updated with new structure and links
• dev/docs/background.md created (Binabase background, theory, architecture)
• dev/docs/devplan.md expanded with development stages

Commits:
$commits
"@

Review mode

if ($Review) {
Write-Host "=== REVIEW MODE ===" -ForegroundColor Cyan
Write-Host ""
Write-Host "Issue: #$IssueNumber $IssueTitle" -ForegroundColor Yellow
Write-Host "Link: $issueLink" -ForegroundColor Yellow
Write-Host "State: $($issueObj.state)" -ForegroundColor Yellow
Write-Host ""
Write-Host "Labels:" -ForegroundColor Green
if ($issueObj.labels) {
$issueObj.labels | ForEach-Object { Write-Host " - $($.name)" }
} else {
Write-Host " (none)" -ForegroundColor Gray
}
Write-Host ""
Write-Host "Recent commits (issue #$IssueNumber or last 10):" -ForegroundColor Green
$commits | ForEach-Object { Write-Host " $" }
Write-Host ""
Write-Host "Proposed close comment:" -ForegroundColor Green
Write-Host $closeComment -ForegroundColor White
Write-Host ""
Write-Host "Ask AI to review this output before running with -Execute" -ForegroundColor Yellow
Write-Host "Note: Moving to project 'DONE' column requires additional project-specific setup" -ForegroundColor Gray
exit 0
}

Execute mode

if ($Execute) {
Write-Host "=== EXECUTING ===" -ForegroundColor Cyan
Write-Host "Closing issue #$IssueNumber..." -ForegroundColor Yellow

# Close issue with comment
gh issue close $IssueNumber --repo pashute/binabase --comment $closeComment
if ($LASTEXITCODE -ne 0) {
    Write-Host "Failed to close issue!" -ForegroundColor Red
    exit 1
}

Write-Host "Issue #$IssueNumber closed successfully!" -ForegroundColor Green
Write-Host "Note: To move to project 'DONE' column, you'll need project ID and field ID" -ForegroundColor Gray
exit 0

}

Default: show usage

Write-Host "Usage:" -ForegroundColor Cyan
Write-Host " .\closeProjmanItem.ps1 -IssueNumber <#> -Review # Review before closing"
Write-Host " .\closeProjmanItem.ps1 -IssueNumber <#> -Execute # Execute close with comment"
Write-Host " .\closeProjmanItem.ps1 -IssueNumber <#> -IssueTitle <title> -Execute"