Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5ac39bcb41 | ||
|
|
b81c488d46 | ||
|
|
f869dfb4d0 | ||
|
|
428b96c982 | ||
|
|
cd0bc3d202 | ||
|
|
5ad5452276 | ||
|
|
726da18dc7 | ||
|
|
3a4f2077be | ||
|
|
864577857d | ||
|
|
a33fc3eb1a | ||
|
|
85dfd5dcdd |
@@ -28,7 +28,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\"; [ -f \"$SH\" ] || SH=$(ls \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\" 2>/dev/null | head -1); [ -n \"$SH\" ] && [ -f \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
---
|
||||
|
||||
# Planning with Files
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -468,10 +468,13 @@ def _opencode_state_annotation(state: Any) -> str:
|
||||
|
||||
def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dict[str, Any]]:
|
||||
"""Print-ready summary for one OpenCode part row."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -486,7 +489,8 @@ def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dic
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}{outcome}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}{outcome}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual evidence in findings.md.
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
"name": "planning-with-files",
|
||||
"source": "./",
|
||||
"description": "Persistent project planning files with lifecycle hooks that inject selected plan context. Automatic recovery uses project files only. Explicit catchup modes may read same-project local session records to emit aggregate counts or bounded nonce-framed excerpts. Optional gated mode can request continuation on capable hosts and never runs commands declared in Markdown. No network upload path. Installs across 60+ agents.",
|
||||
"version": "3.20.3"
|
||||
"version": "3.20.5"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "planning-with-files",
|
||||
"version": "3.20.3",
|
||||
"version": "3.20.5",
|
||||
"description": "Persistent project planning files with lifecycle hooks that inject selected plan context. Automatic recovery uses project files only. Explicit catchup modes may read same-project local session records to emit aggregate counts or bounded nonce-framed excerpts. Optional gated mode can request continuation on capable hosts and never runs commands declared in Markdown. No network upload path. Works across 60+ agents and includes Arabic, German, Spanish, Simplified Chinese, and Traditional Chinese.",
|
||||
"author": {
|
||||
"name": "OthmanAdi",
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"${CODEBUDDY_PLUGIN_ROOT}/scripts/skill-hook.sh\" \"$HOME/.codebuddy/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -468,10 +468,13 @@ def _opencode_state_annotation(state: Any) -> str:
|
||||
|
||||
def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dict[str, Any]]:
|
||||
"""Print-ready summary for one OpenCode part row."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -486,7 +489,8 @@ def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dic
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}{outcome}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}{outcome}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual evidence in findings.md.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "planning-with-files",
|
||||
"version": "3.20.3",
|
||||
"version": "3.20.5",
|
||||
"description": "Persistent project planning for Codex. Opt-in lifecycle hooks inject selected plan context; automatic recovery uses project files only. Explicit catchup modes may read same-project local session records to emit aggregate counts or bounded nonce-framed excerpts. Optional gated mode can request continuation on capable hosts and never runs Markdown-declared commands. No network upload path.",
|
||||
"author": {
|
||||
"name": "OthmanAdi",
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.codex/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -468,10 +468,13 @@ def _opencode_state_annotation(state: Any) -> str:
|
||||
|
||||
def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dict[str, Any]]:
|
||||
"""Print-ready summary for one OpenCode part row."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -486,7 +489,8 @@ def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dic
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}{outcome}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}{outcome}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual evidence in findings.md.
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -468,10 +468,13 @@ def _opencode_state_annotation(state: Any) -> str:
|
||||
|
||||
def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dict[str, Any]]:
|
||||
"""Print-ready summary for one OpenCode part row."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -486,7 +489,8 @@ def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dic
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}{outcome}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}{outcome}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -88,9 +88,13 @@ function Resolve-CursorPlanContext {
|
||||
# inject-plan.sh is. A stale pointer text, a dot-named directory or an
|
||||
# invalid slug is ignored the way inject-plan.sh ignores it, so the legacy
|
||||
# root applies, as on every other route.
|
||||
# A pointer that is a directory or a symlink is unsafe. LinkType, not the
|
||||
# ReparsePoint attribute: OneDrive Files On-Demand marks every synced file
|
||||
# as a reparse point and such a pointer is a plain file to every other
|
||||
# route; the attribute test made this hook go silent on OneDrive (#275).
|
||||
$activeItem = Get-Item -LiteralPath (Join-Path $planRoot '.active_plan') -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem -and ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0))) {
|
||||
(([string]$activeItem.LinkType) -in @('SymbolicLink', 'Junction')))) {
|
||||
return (New-CursorPlanContext $null 'invalid' 'unsafe-pointer')
|
||||
}
|
||||
if ($planRootExists) {
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.cursor/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -468,10 +468,13 @@ def _opencode_state_annotation(state: Any) -> str:
|
||||
|
||||
def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dict[str, Any]]:
|
||||
"""Print-ready summary for one OpenCode part row."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -486,7 +489,8 @@ def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dic
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}{outcome}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}{outcome}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual evidence in findings.md.
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.factory/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
---
|
||||
|
||||
# Planning with Files
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -468,10 +468,13 @@ def _opencode_state_annotation(state: Any) -> str:
|
||||
|
||||
def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dict[str, Any]]:
|
||||
"""Print-ready summary for one OpenCode part row."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -486,7 +489,8 @@ def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dic
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}{outcome}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}{outcome}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual evidence in findings.md.
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -468,10 +468,13 @@ def _opencode_state_annotation(state: Any) -> str:
|
||||
|
||||
def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dict[str, Any]]:
|
||||
"""Print-ready summary for one OpenCode part row."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -486,7 +489,8 @@ def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dic
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}{outcome}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}{outcome}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual evidence in findings.md.
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
name: planning-with-files
|
||||
description: "Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls."
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
hermes:
|
||||
tags: [planning, long-running-tasks, context-engineering, workflow]
|
||||
---
|
||||
|
||||
@@ -7,6 +7,8 @@ param(
|
||||
[string]$Template = "default"
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
$DATE = Get-Date -Format "yyyy-MM-dd"
|
||||
|
||||
# Resolve template directory (skill root is one level up from scripts/)
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State what the analysis should determine or produce in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -84,6 +90,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual findings in findings.md while the evidence is available.
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.mastracode/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -5,6 +5,8 @@ param(
|
||||
[string]$ProjectName = "project"
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
$DATE = Get-Date -Format "yyyy-MM-dd"
|
||||
|
||||
Write-Host "Initializing planning files for: $ProjectName"
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.config/opencode/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.opencode/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -5,6 +5,8 @@ param(
|
||||
[string]$ProjectName = "project"
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
$DATE = Get-Date -Format "yyyy-MM-dd"
|
||||
|
||||
Write-Host "Initializing planning files for: $ProjectName"
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual evidence in findings.md.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "planning-with-files",
|
||||
"version": "3.20.3",
|
||||
"version": "3.20.5",
|
||||
"description": "Persistent project planning with selected context injection. Automatic recovery uses project files only; explicit catchup modes read same-project local session records for aggregate counts or bounded replay. The host-aware gate never runs Markdown-declared commands. No network upload path. Ships the skill plus a Pi Coding Agent extension.",
|
||||
"keywords": [
|
||||
"pi-package",
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -468,10 +468,13 @@ def _opencode_state_annotation(state: Any) -> str:
|
||||
|
||||
def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dict[str, Any]]:
|
||||
"""Print-ready summary for one OpenCode part row."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -486,7 +489,8 @@ def _format_opencode_part(data: Dict[str, Any], session_id: str) -> Optional[Dic
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}{outcome}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}{outcome}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence.
|
||||
|
||||
[One sentence describing the analytical objective]
|
||||
|
||||
## Next Step
|
||||
|
||||
Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes.
|
||||
|
||||
[The single next analytical action. Update whenever phase status changes.]
|
||||
|
||||
## Current Phase
|
||||
|
||||
Name the phase currently being worked on.
|
||||
@@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a
|
||||
## Notes
|
||||
|
||||
- Update phase status as work progresses: `pending` to `in_progress` to `complete`.
|
||||
- Re-read the goal and current phase before major analytical decisions.
|
||||
- Re-read the goal, next step, and current phase before major analytical decisions.
|
||||
- Log errors promptly so failed approaches are not repeated.
|
||||
- Record query results and visual evidence in findings.md.
|
||||
|
||||
@@ -4,6 +4,26 @@ All notable changes to this project will be documented in this file.
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
## [3.20.5] - 2026-09-21
|
||||
|
||||
### Fixed
|
||||
- OpenCode session replay tolerates null or array part rows, non-string tool names, and non-string text instead of aborting the session. Healthy rows remain available, and the defensive checks are synchronized across the copies that carry this formatter (#269, PR #273).
|
||||
- Shell and PowerShell initialization now report failed attestation as `NOT attested`, with a reason and recovery command, instead of claiming success. Attestation failure remains non-aborting, and inherited plan selectors are restored after the attempt (#276, PR #277).
|
||||
- The analytics task-plan template includes a non-empty `## Next Step` section across its shipped copies. Structural and initializer regressions keep generated analytics plans compatible with lifecycles that require that section (#278, PR #279).
|
||||
- PowerShell planning-file writes fail with a non-zero exit status and an error when access is denied. Named plans become active only after all three planning files are ready, so a failed initialization preserves the previous active pointer. The separately maintained host and translated initializers also stop on write errors (#255, PR #280).
|
||||
|
||||
### Thanks
|
||||
- @TayfurYldz, for the malformed OpenCode replay guards and regression coverage in #273.
|
||||
- @kuei51307-hub, for attestation failure reporting in #277 and the analytics Next Step fix in #279.
|
||||
- @ShaunLinTW, for denied-write handling, safe activation ordering, and Windows regression coverage in #280.
|
||||
- @mfehlhaber, for reporting the missing analytics Next Step section in #278.
|
||||
|
||||
## [3.20.4] - 2026-09-19
|
||||
|
||||
### Fixed
|
||||
- PowerShell route on OneDrive: `resolve-plan-dir.ps1`, the Cursor hook `resolve-plan-context.ps1` and `set-active-plan.ps1` refused an `.active_plan` pointer that carried the `ReparsePoint` file attribute. OneDrive Files On-Demand sets that attribute on every synced file, so in a project under OneDrive the Cursor hooks stopped with the unsafe-pointer notice instead of injecting the pointed plan, the resolver printed nothing for `attest-plan.ps1` and `check-complete.ps1`, and `set-active-plan.ps1` refused to write, while every other route read the pointer normally. The three checks now refuse a container or a `LinkType` of `SymbolicLink` or `Junction`, the predicate v3.20.3 gave the directory checks and the `[ -L ]` of the shell scripts. `attest-plan.ps1` had the same class of check in its native helper and refused to hash, show or clear any reparse-point file, so attestation failed in every project under OneDrive while `init-session.ps1` still reported the plan as attested; it now refuses only name-surrogate reparse points (symlinks, junctions and unknown surrogate tags), which is the set Windows path parsing follows (#275).
|
||||
- `tests/test_session_catchup_copies_exact_basename.py` walked the whole checkout and loaded any untracked `session-catchup.py`, so a stale clone kept under the gitignored `.planning/` on a maintainer machine failed the two tests with 120 subtests while CI stayed green. The copies now come from `git ls-files`; the filtered walk is kept only for a checkout without git (#274).
|
||||
|
||||
## [3.20.3] - 2026-09-19
|
||||
|
||||
### Fixed
|
||||
|
||||
+2
-2
@@ -7,8 +7,8 @@ authors:
|
||||
- family-names: Adi
|
||||
given-names: Ahmad Othman Ammar
|
||||
alias: OthmanAdi
|
||||
version: "3.20.3"
|
||||
date-released: "2026-09-19"
|
||||
version: "3.20.5"
|
||||
date-released: "2026-09-21"
|
||||
license: MIT
|
||||
url: "https://github.com/OthmanAdi/planning-with-files"
|
||||
repository-code: "https://github.com/OthmanAdi/planning-with-files"
|
||||
|
||||
+8
-5
@@ -109,23 +109,26 @@ These amazing people have contributed code, documentation, or significant improv
|
||||
- **[@ericshunhinglee-cloud](https://github.com/ericshunhinglee-cloud)**, [Issue #272](https://github.com/OthmanAdi/planning-with-files/issues/272)
|
||||
- Reported and traced the Hermes 0.21.3 first-turn `TERMINAL_CWD` rewrite that made the Hermes plugin resolve the home directory as the project root, with a setter stack trace, on-the-wire token evidence and the upstream cross-references.
|
||||
|
||||
- **[Shaun Lin](https://github.com/ShaunLinTW)**, [PR #245](https://github.com/OthmanAdi/planning-with-files/pull/245), [PR #247](https://github.com/OthmanAdi/planning-with-files/pull/247), [PR #263](https://github.com/OthmanAdi/planning-with-files/pull/263), [PR #271](https://github.com/OthmanAdi/planning-with-files/pull/271)
|
||||
- **[Shaun Lin](https://github.com/ShaunLinTW)**, [PR #245](https://github.com/OthmanAdi/planning-with-files/pull/245), [PR #247](https://github.com/OthmanAdi/planning-with-files/pull/247), [PR #263](https://github.com/OthmanAdi/planning-with-files/pull/263), [PR #271](https://github.com/OthmanAdi/planning-with-files/pull/271), [PR #280](https://github.com/OthmanAdi/planning-with-files/pull/280)
|
||||
- Isolated Python calls in the Codex, Gemini, and GitHub Copilot shell adapters and added regression coverage for project-local import shadowing.
|
||||
- Added named-plan slug mode to the PowerShell initializer with root-mode policy inheritance, host-aware attestation, and Windows PowerShell regression coverage.
|
||||
- Made the OpenCode session catchup adapter skip malformed part rows instead of raising, with regression coverage for the string-state and invalid-JSON shapes.
|
||||
- Made the shell several-plans counters skip symlinked and junctioned plan directories so they match the Hermes plugin, with a differential regression including the ambiguity probe.
|
||||
- Made denied PowerShell planning-file writes fail explicitly and deferred named-plan activation until all three files are ready, with real Windows ACL regression coverage.
|
||||
|
||||
- **[@TayfurYldz](https://github.com/TayfurYldz)**, [PR #265](https://github.com/OthmanAdi/planning-with-files/pull/265), [PR #266](https://github.com/OthmanAdi/planning-with-files/pull/266)
|
||||
- **[@TayfurYldz](https://github.com/TayfurYldz)**, [PR #265](https://github.com/OthmanAdi/planning-with-files/pull/265), [PR #266](https://github.com/OthmanAdi/planning-with-files/pull/266), [PR #273](https://github.com/OthmanAdi/planning-with-files/pull/273)
|
||||
- Bound `PWF_PLAN_ROOT` to the current project around the attestation call in both initializers so an inherited pin cannot redirect attestation, with shell and PowerShell regressions.
|
||||
- Made the shell slugifier single-line so a plan name with an embedded newline no longer creates an unusable plan directory.
|
||||
- Guarded OpenCode replay against null and array rows, non-string tool names, and object-valued text while retaining healthy session rows.
|
||||
|
||||
- **[@kuei51307-hub](https://github.com/kuei51307-hub)**, [PR #243](https://github.com/OthmanAdi/planning-with-files/pull/243), [PR #244](https://github.com/OthmanAdi/planning-with-files/pull/244), [PR #248](https://github.com/OthmanAdi/planning-with-files/pull/248), [PR #249](https://github.com/OthmanAdi/planning-with-files/pull/249), [PR #251](https://github.com/OthmanAdi/planning-with-files/pull/251), [PR #267](https://github.com/OthmanAdi/planning-with-files/pull/267)
|
||||
- **[@kuei51307-hub](https://github.com/kuei51307-hub)**, [PR #243](https://github.com/OthmanAdi/planning-with-files/pull/243), [PR #244](https://github.com/OthmanAdi/planning-with-files/pull/244), [PR #248](https://github.com/OthmanAdi/planning-with-files/pull/248), [PR #249](https://github.com/OthmanAdi/planning-with-files/pull/249), [PR #251](https://github.com/OthmanAdi/planning-with-files/pull/251), [PR #267](https://github.com/OthmanAdi/planning-with-files/pull/267), [PR #277](https://github.com/OthmanAdi/planning-with-files/pull/277), [PR #279](https://github.com/OthmanAdi/planning-with-files/pull/279)
|
||||
- Fixed active-plan display and listing for UTF-8 BOM-prefixed pointers, with regression coverage across the synchronized shell helpers.
|
||||
- Made IDE sync verification report missing canonical sources, with subprocess tests for read-only verification and unchanged sync behavior.
|
||||
- Bounded session catchup to exact planning filenames across the canonical scanners and the Hermes, MastraCode, and OpenCode adapters, with lookalike regression coverage.
|
||||
- Replaced the shell initializer's active-pointer write with the selector's contained atomic update and added hardlink, symlink, and junction regressions.
|
||||
- Routed Cursor's native PowerShell hooks through the shared plan resolver so named plans are injected on Windows, and made the resolver's `PWF_PLAN_ROOT` check run on Windows PowerShell 5.1.
|
||||
- Ported the several-plans rule into the Hermes plugin so two or more named plans without `PLAN_ID` get the selector notice instead of a pointer or timestamp guess.
|
||||
- Made shell and PowerShell initialization report attestation failures with a recovery command, and added the missing analytics Next Step section across template copies with regression coverage.
|
||||
|
||||
- **[@Dphoshoba](https://github.com/Dphoshoba)**, [PR #242](https://github.com/OthmanAdi/planning-with-files/pull/242)
|
||||
- Proposed and implemented named-plan listing with phase counts and a shared active-pointer marker.
|
||||
@@ -417,7 +420,7 @@ Thank you to everyone who reported issues, provided feedback, and helped test fi
|
||||
- [@popey](https://github.com/popey) (Alan Pope) - [PR #215](https://github.com/OthmanAdi/planning-with-files/pull/215) (bumped the pinned Tessl action SHA past a migration that had silently stopped reviews from running; the range it moves across also closes a marker-spoofing hole in the commit this repo had been pinned to)
|
||||
- [@SomSamantray](https://github.com/SomSamantray) (Som Samantray) - [PR #216](https://github.com/OthmanAdi/planning-with-files/pull/216) (audited the language variants against the canonical skill and proved the drift issue #130 predicted: 12 missing scripts, a missing Windows UTF-8 fix, and sync tooling that covered only 3 dispatch targets; that analysis is what v3.10.0 acted on, closing the gap additively instead of by deletion)
|
||||
- [@marcmuon](https://github.com/marcmuon) (Marc Kelechava) - Issue #195 (one-shot `codex exec` sessions sharing a cwd with an incomplete plan got hijacked and mutated orchestrator-owned plan files; the report's reproductions, root-cause file list, and acceptance criteria shipped directly as the `PLANNING_DISABLED=1` opt-out in v3.4.0)
|
||||
- [@mfehlhaber](https://github.com/mfehlhaber): Issue #220 (identified that the Codex POSIX `SessionStart` and `UserPromptSubmit` routes bypassed the JSON adapter, causing planning context beginning with `[` to be rejected as invalid event JSON; fixed in v3.10.1), Issue #231 (traced Pi's generic attestation failure to six CRLF shell scripts in the npm `3.10.2` tarball, separated the clean repository source from the broken package artifact, and identified the missing package-time validation boundary)
|
||||
- [@mfehlhaber](https://github.com/mfehlhaber): Issue #220 (identified that the Codex POSIX `SessionStart` and `UserPromptSubmit` routes bypassed the JSON adapter, causing planning context beginning with `[` to be rejected as invalid event JSON; fixed in v3.10.1), Issue #231 (traced Pi's generic attestation failure to six CRLF shell scripts in the npm `3.10.2` tarball, separated the clean repository source from the broken package artifact, and identified the missing package-time validation boundary); [Issue #278](https://github.com/OthmanAdi/planning-with-files/issues/278) (reported the missing Next Step section in generated analytics plans, fixed in v3.20.5)
|
||||
|
||||
- [@Whxuan0701](https://github.com/Whxuan0701) (WeiHaoxuan) - [PR #223](https://github.com/OthmanAdi/planning-with-files/pull/223), [PR #222](https://github.com/OthmanAdi/planning-with-files/pull/222), [PR #224](https://github.com/OthmanAdi/planning-with-files/pull/224) (found that the `PLANNING_DISABLED=1` opt-out from #195 had never reached any of the ten GitHub Copilot hook entry points, that the #191 zero-phase guard was missing from the Copilot PowerShell stop hook, and that the Hermes determinism probe hardcoded `python` so it could not run where only `python3` exists; three single-commit PRs, each with a test that executes the real script. Auditing them surfaced three further defects fixed in the same release: the Cursor route had the same opt-out gap across all eight of its hooks, the disabled `PreToolUse` branch was widening Copilot's permissions rather than staying neutral, and `error-occurred.ps1` had never logged an error on Windows because it read stdin into PowerShell's automatic `$input` variable)
|
||||
|
||||
@@ -452,4 +455,4 @@ If you've contributed and don't see your name here, please open an issue! We wan
|
||||
|
||||
**Total Contributors:** 65+ and growing!
|
||||
|
||||
*Last updated: 2026-09-19*
|
||||
*Last updated: 2026-09-21*
|
||||
|
||||
@@ -347,6 +347,8 @@ One hook fire measures 289ms wall-clock since the v3.6.0 optimization, down from
|
||||
|
||||
| Version | Highlights |
|
||||
|---------|------------|
|
||||
| **v3.20.5** | OpenCode replay tolerates malformed parts (#273). Initialization reports attestation failures accurately (#277), analytics plans include Next Step (#279), and PowerShell denied writes fail without activating an incomplete named plan (#280). |
|
||||
| **v3.20.4** | PowerShell route on OneDrive: an `.active_plan` pointer carrying the OneDrive Files On-Demand reparse attribute no longer counts as unsafe, so the Cursor hooks, the resolver and `set-active-plan.ps1` work in projects under OneDrive (#275). The session-catchup copy guard checks tracked copies only (#274). |
|
||||
| **v3.20.3** | A symlinked or junctioned directory under `.planning/` is never a plan on any route: the shell counters skip it (PR #271 by @ShaunLinTW, #270), and the selection paths of the shell family plus the Codex, OpenCode and DSH counters refuse it too, so one real plan next to a linked one no longer becomes an mtime guess. |
|
||||
| **v3.20.2** | Hermes plugin: Hermes 0.21.3 re-homes `TERMINAL_CWD` to the home directory on the first CLI turn, so the plan in the launch directory was skipped silently. The first turn now says why nothing was injected and names the `PWF_PLAN_ROOT` pin, `/pwf-status` and `/pwf` print the same diagnostic, and the slash commands honor the pin (#272, reported by @ericshunhinglee-cloud). |
|
||||
| **v3.20.1** | Fixes four maintainer-filed issues from the v3.19.0 and v3.20.0 cycles: newline-safe shell slugs (#257, PR #266 by @TayfurYldz), attestation bound to the current project when `PWF_PLAN_ROOT` is inherited (#261, PR #265 by @TayfurYldz), malformed OpenCode part rows skipped by session catchup (#258, PR #263 by @ShaunLinTW), and the several-plans rule in the Hermes plugin (#264, PR #267 by @kuei51307-hub). |
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
+97
-29
@@ -80,6 +80,26 @@ function Get-InheritedMode([string]$CurrentMode) {
|
||||
return $CurrentMode
|
||||
}
|
||||
|
||||
function Format-AttestationFailureReason {
|
||||
param([object[]]$Output, [string]$Fallback)
|
||||
|
||||
$Reason = @(
|
||||
$Output |
|
||||
ForEach-Object {
|
||||
if ($null -ne $_) { ($_.ToString()).Trim() }
|
||||
} |
|
||||
Where-Object { $_ }
|
||||
) -join " "
|
||||
$Reason = ($Reason -replace '\s+', ' ').Trim()
|
||||
if ([string]::IsNullOrWhiteSpace($Reason)) {
|
||||
return $Fallback
|
||||
}
|
||||
if ($Reason.Length -gt 300) {
|
||||
return ($Reason.Substring(0, 297) + "...")
|
||||
}
|
||||
return $Reason
|
||||
}
|
||||
|
||||
# Validate template
|
||||
if ($Template -ne "default" -and $Template -ne "analytics") {
|
||||
Write-Host "Unknown template: $Template (available: default, analytics). Using default."
|
||||
@@ -136,20 +156,7 @@ if ($UsePlanDir) {
|
||||
$Counter++
|
||||
}
|
||||
$TargetDir = Join-Path $PlanningRoot $PlanId
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
|
||||
# Reuse the selector's contained, atomic pointer replacement. Set-Content
|
||||
# would follow a reparse point and truncate a hardlinked pointer in place,
|
||||
# overwriting whichever file shares that inode.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
New-Item -ItemType Directory -Path $TargetDir -Force -ErrorAction Stop | Out-Null
|
||||
$Mode = Get-InheritedMode $Mode
|
||||
} else {
|
||||
$TargetDir = (Get-Location).Path
|
||||
@@ -173,11 +180,12 @@ if ($UsePlanDir) {
|
||||
Write-Host "PLAN_ID=$PlanId"
|
||||
}
|
||||
|
||||
try {
|
||||
# Create task_plan.md if it doesn't exist
|
||||
if (-not (Test-Path -LiteralPath $TaskPlanPath)) {
|
||||
$AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath
|
||||
Copy-Item -LiteralPath $AnalyticsPlan -Destination $TaskPlanPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Task Plan: [Brief Description]
|
||||
@@ -226,7 +234,7 @@ Phase 1
|
||||
## Errors Encountered
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $TaskPlanPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $TaskPlanDisplay"
|
||||
} else {
|
||||
@@ -237,7 +245,7 @@ Phase 1
|
||||
if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
$AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
|
||||
if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath
|
||||
Copy-Item -LiteralPath $AnalyticsFindings -Destination $FindingsPath -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Findings & Decisions
|
||||
@@ -258,7 +266,7 @@ if (-not (Test-Path -LiteralPath $FindingsPath)) {
|
||||
|
||||
## Resources
|
||||
-
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $FindingsPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $FindingsDisplay"
|
||||
} else {
|
||||
@@ -287,7 +295,7 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
} else {
|
||||
@"
|
||||
# Progress Log
|
||||
@@ -308,12 +316,32 @@ if (-not (Test-Path -LiteralPath $ProgressPath)) {
|
||||
### Errors
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8
|
||||
"@ | Out-File -LiteralPath $ProgressPath -Encoding UTF8 -ErrorAction Stop
|
||||
}
|
||||
Write-Host "Created $ProgressDisplay"
|
||||
} else {
|
||||
Write-Host "$ProgressDisplay already exists, skipping"
|
||||
}
|
||||
} catch {
|
||||
Write-Error "Error: could not initialize planning files in '$TargetDir': $($_.Exception.Message)"
|
||||
exit 1
|
||||
}
|
||||
|
||||
if ($UsePlanDir) {
|
||||
# Activate the named plan only after all three planning files are ready.
|
||||
# This matches init-session.sh and prevents a failed initialization from
|
||||
# leaving .active_plan pointed at a partial plan directory.
|
||||
$global:LASTEXITCODE = 0
|
||||
try {
|
||||
& $PlanSelector $PlanId *> $null
|
||||
} catch {
|
||||
$global:LASTEXITCODE = 1
|
||||
}
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
Write-Error "Error: could not safely update the active plan pointer at $(Join-Path $PlanningRoot '.active_plan')."
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Planning files initialized!"
|
||||
@@ -355,8 +383,11 @@ if ($Mode -ne "") {
|
||||
# to another project or plan (#261, #237). Root mode clears both instead:
|
||||
# the attester only falls back to the legacy ./task_plan.md when no
|
||||
# selector is set, and a bound pin would make it refuse the root plan.
|
||||
$AttestationSucceeded = $false
|
||||
$AttestationCommand = "attest-plan"
|
||||
$AttestationReason = "task_plan.md was not available for attestation"
|
||||
$PlanFilePwf = Join-Path $PlanDirPwf "task_plan.md"
|
||||
if (Test-Path -LiteralPath $PlanFilePwf) {
|
||||
if (Test-Path -LiteralPath $PlanFilePwf -PathType Leaf) {
|
||||
$HadPlanId = Test-Path Env:PLAN_ID
|
||||
$PreviousPlanId = $env:PLAN_ID
|
||||
$HadPlanRoot = Test-Path Env:PWF_PLAN_ROOT
|
||||
@@ -370,21 +401,54 @@ if ($Mode -ne "") {
|
||||
Remove-Item Env:PLAN_ID -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
# A called script can return without changing $LASTEXITCODE, so
|
||||
# clear the inherited value before every attempt. Both a non-zero
|
||||
# status and a terminating exception mean the plan is not attested.
|
||||
$global:LASTEXITCODE = 0
|
||||
$AttestOutput = @()
|
||||
$IsWindowsHost = [Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT
|
||||
if ($IsWindowsHost) {
|
||||
$AttestPs1 = Join-Path $ScriptDir "attest-plan.ps1"
|
||||
if (Test-Path -LiteralPath $AttestPs1) {
|
||||
& $AttestPs1 *> $null
|
||||
$AttestationCommand = "attest-plan.ps1"
|
||||
$AttestPs1 = Join-Path $ScriptDir $AttestationCommand
|
||||
if (Test-Path -LiteralPath $AttestPs1 -PathType Leaf) {
|
||||
$AttestOutput = @(& $AttestPs1 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
} else {
|
||||
$AttestSh = Join-Path $ScriptDir "attest-plan.sh"
|
||||
$AttestationCommand = "attest-plan.sh"
|
||||
$AttestSh = Join-Path $ScriptDir $AttestationCommand
|
||||
$Sh = Get-Command sh -ErrorAction SilentlyContinue
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh)) {
|
||||
& $Sh.Path $AttestSh *> $null
|
||||
if ($Sh -and (Test-Path -LiteralPath $AttestSh -PathType Leaf)) {
|
||||
$AttestOutput = @(& $Sh.Path $AttestSh 2>&1)
|
||||
$AttestExitCode = $LASTEXITCODE
|
||||
if ($AttestExitCode -eq 0) {
|
||||
$AttestationSucceeded = $true
|
||||
$AttestationReason = ""
|
||||
} else {
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output $AttestOutput `
|
||||
-Fallback "$AttestationCommand exited with code $AttestExitCode"
|
||||
}
|
||||
} elseif (-not $Sh) {
|
||||
$AttestationReason = "sh was not found; $AttestationCommand could not run"
|
||||
} else {
|
||||
$AttestationReason = "$AttestationCommand was not found beside init-session.ps1"
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
# attestation failure must not abort init; the mode marker still stands.
|
||||
$AttestationReason = Format-AttestationFailureReason `
|
||||
-Output @($_) `
|
||||
-Fallback "$AttestationCommand failed"
|
||||
} finally {
|
||||
if ($HadPlanId) {
|
||||
$env:PLAN_ID = $PreviousPlanId
|
||||
@@ -399,5 +463,9 @@ if ($Mode -ne "") {
|
||||
}
|
||||
}
|
||||
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
if ($AttestationSucceeded) {
|
||||
Write-Host "Mode: $MarkerText (attested, gate counter reset)"
|
||||
} else {
|
||||
Write-Host "Mode: $MarkerText (NOT attested: $AttestationReason; run $AttestationCommand before the first hook fire)"
|
||||
}
|
||||
}
|
||||
|
||||
+52
-7
@@ -186,6 +186,10 @@ apply_v3_mode() {
|
||||
_mode_plan="$2"
|
||||
[ -z "$MODE" ] && return 0
|
||||
|
||||
ATTESTATION_OK=0
|
||||
ATTESTATION_COMMAND="attest-plan.sh"
|
||||
ATTESTATION_REASON="task_plan.md was not available for attestation"
|
||||
|
||||
# (a) reset the gate block counter and drop any stale gate ledger so a prior
|
||||
# run's high block count cannot let the next run stop instantly.
|
||||
printf '0\n' > "${_mode_dir}/.stop_blocks"
|
||||
@@ -210,13 +214,54 @@ apply_v3_mode() {
|
||||
# ./task_plan.md when no selector is set, and a bound pin would make it
|
||||
# refuse the root plan. Run from the project root (CWD here) so both
|
||||
# resolutions land.
|
||||
_attest="${SCRIPT_DIR}/attest-plan.sh"
|
||||
if [ -f "${_attest}" ] && [ -f "${_mode_plan}" ]; then
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest="${SCRIPT_DIR}/${ATTESTATION_COMMAND}"
|
||||
if [ ! -f "${_attest}" ]; then
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} was not found beside init-session.sh"
|
||||
return 0
|
||||
fi
|
||||
if [ ! -f "${_mode_plan}" ]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
if _attest_output="$(PWF_PLAN_ROOT="$PWD" PLAN_ID="${PLAN_ID}" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" >/dev/null 2>&1 || true
|
||||
_attest_rc=$?
|
||||
fi
|
||||
else
|
||||
if _attest_output="$(PWF_PLAN_ROOT="" PLAN_ID="" sh "${_attest}" 2>&1)"; then
|
||||
ATTESTATION_OK=1
|
||||
ATTESTATION_REASON=""
|
||||
return 0
|
||||
else
|
||||
_attest_rc=$?
|
||||
fi
|
||||
fi
|
||||
|
||||
_attest_reason="$(
|
||||
printf '%s\n' "${_attest_output}" |
|
||||
sed -n '/[^[:space:]]/ { s/[[:space:]][[:space:]]*/ /g; s/^ //; s/ $//; p; q; }' |
|
||||
cut -c1-300
|
||||
)"
|
||||
if [ -n "${_attest_reason}" ]; then
|
||||
ATTESTATION_REASON="${_attest_reason}"
|
||||
else
|
||||
ATTESTATION_REASON="${ATTESTATION_COMMAND} exited with code ${_attest_rc}"
|
||||
fi
|
||||
return 0
|
||||
}
|
||||
|
||||
print_v3_mode_status() {
|
||||
_status_dir="$1"
|
||||
_marker="$(cat "${_status_dir}/.mode")"
|
||||
if [ "${ATTESTATION_OK:-0}" -eq 1 ]; then
|
||||
printf 'Mode: %s (attested, gate counter reset)\n' "${_marker}"
|
||||
else
|
||||
printf 'Mode: %s (NOT attested: %s; run %s before the first hook fire)\n' \
|
||||
"${_marker}" "${ATTESTATION_REASON:-attestation failed}" "${ATTESTATION_COMMAND:-attest-plan.sh}"
|
||||
fi
|
||||
}
|
||||
|
||||
@@ -431,7 +476,7 @@ if [ "$SLUG_MODE" -eq 1 ]; then
|
||||
echo "Pin this terminal to the plan for parallel sessions:"
|
||||
echo " export PLAN_ID=$PLAN_ID"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "${PLAN_DIR}/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "${PLAN_DIR}"
|
||||
fi
|
||||
else
|
||||
PROJECT_NAME="${PROJECT_NAME:-project}"
|
||||
@@ -442,6 +487,6 @@ else
|
||||
echo "Planning files initialized!"
|
||||
echo "Files: task_plan.md, findings.md, progress.md"
|
||||
if [ -n "$MODE" ]; then
|
||||
echo "Mode: $(cat "$(pwd)/.mode") (attested, gate counter reset)"
|
||||
print_v3_mode_status "$(pwd)"
|
||||
fi
|
||||
fi
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -482,10 +482,13 @@ def get_opencode_db_path() -> Optional[Path]:
|
||||
|
||||
def _format_opencode_part(data: Dict, session_id: str) -> Optional[Dict]:
|
||||
"""Convert one OpenCode part row's JSON `data` blob into a print-ready summary."""
|
||||
if not isinstance(data, dict):
|
||||
return None
|
||||
ptype = data.get('type')
|
||||
short = safe_session_label(session_id)
|
||||
if ptype == 'tool':
|
||||
tool = (data.get('tool') or '').lower()
|
||||
tool_value = data.get('tool')
|
||||
tool = tool_value.lower() if isinstance(tool_value, str) else ''
|
||||
state = data.get('state') or {}
|
||||
input_ = state.get('input') if isinstance(state, dict) else None
|
||||
input_ = input_ if isinstance(input_, dict) else {}
|
||||
@@ -499,7 +502,8 @@ def _format_opencode_part(data: Dict, session_id: str) -> Optional[Dict]:
|
||||
return {'session': short, 'summary': f"Tool bash: {cmd}"}
|
||||
return {'session': short, 'summary': f"Tool {tool}"}
|
||||
if ptype == 'text':
|
||||
text = (data.get('text') or '')[:300]
|
||||
text_value = data.get('text')
|
||||
text = text_value[:300] if isinstance(text_value, str) else ''
|
||||
if text.strip():
|
||||
return {'session': short, 'summary': f"text: {text}"}
|
||||
return None
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files-ar/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
---
|
||||
|
||||
# نظام تخطيط الملفات
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -5,6 +5,8 @@ param(
|
||||
[string]$ProjectName = "project"
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
$DATE = Get-Date -Format "yyyy-MM-dd"
|
||||
|
||||
Write-Host "جارٍ تهيئة ملفات التخطيط: $ProjectName"
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files-de/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
---
|
||||
|
||||
# Dateiplanungssystem
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -5,6 +5,8 @@ param(
|
||||
[string]$ProjectName = "projekt"
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
$DATE = Get-Date -Format "yyyy-MM-dd"
|
||||
|
||||
Write-Host "Initialisiere Planungsdateien: $ProjectName"
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
@@ -121,9 +121,13 @@ function Test-SafeActiveFile {
|
||||
param([switch]$AllowLink)
|
||||
$item = Get-Item -LiteralPath $ActiveFile -Force -ErrorAction SilentlyContinue
|
||||
if (-not $item) { return $false }
|
||||
# Reading may follow a verified in-project link; writing must not.
|
||||
# Reading may follow a verified in-project link; writing must not. A link
|
||||
# is a symlink or junction by LinkType, never the bare ReparsePoint
|
||||
# attribute: OneDrive Files On-Demand marks every synced file as a
|
||||
# reparse point, and the pointer must stay writable there (#275).
|
||||
$linked = ([string]$item.LinkType) -in @('SymbolicLink', 'Junction')
|
||||
return -not $item.PSIsContainer -and
|
||||
($AllowLink -or (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0)) -and
|
||||
($AllowLink -or -not $linked) -and
|
||||
(Test-WithinRoot $ActiveFile)
|
||||
}
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ hooks:
|
||||
- type: command
|
||||
command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files-es/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
|
||||
metadata:
|
||||
version: "3.20.3"
|
||||
version: "3.20.5"
|
||||
---
|
||||
|
||||
# Sistema de Planificación con Archivos
|
||||
|
||||
@@ -116,7 +116,13 @@ public static class PwfAttestationNative {
|
||||
handle, FileAttributeTagInfo, out tag,
|
||||
(uint)Marshal.SizeOf(typeof(FILE_ATTRIBUTE_TAG_INFO))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0)
|
||||
// Refuse only name-surrogate reparse points (symlinks, junctions, and any
|
||||
// unknown tag with bit 29 set): those are what path parsing follows. A
|
||||
// OneDrive Files On-Demand placeholder (tag 0x9000601A) is a regular file
|
||||
// that every other route reads; refusing it broke attestation, --show
|
||||
// and --clear in every project under OneDrive (#275).
|
||||
if ((tag.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0 &&
|
||||
(tag.ReparseTag & 0x20000000) != 0)
|
||||
throw new IOException("Refusing a reparse-point file.");
|
||||
if ((tag.FileAttributes & (uint)FileAttributes.Directory) != 0)
|
||||
throw new IOException("Refusing a directory where a regular file is required.");
|
||||
|
||||
@@ -5,6 +5,8 @@ param(
|
||||
[string]$ProjectName = "project"
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
$DATE = Get-Date -Format "yyyy-MM-dd"
|
||||
|
||||
Write-Host "Inicializando archivos de planificación: $ProjectName"
|
||||
|
||||
@@ -144,7 +144,8 @@ function Test-WithinRoot {
|
||||
# (#270). This is `[ -L ]` of resolve-plan-dir.sh and is_link of the Python
|
||||
# twin: LinkType names symlinks and junctions only. The ReparsePoint
|
||||
# attribute alone would also match OneDrive Files On-Demand placeholders,
|
||||
# which every synced directory carries and which are not links to sh.
|
||||
# which every synced directory and file carries and which are not links to
|
||||
# sh. The same predicate guards the pointer file below (#275).
|
||||
function Test-LinkedDirectory {
|
||||
param($PathOrItem)
|
||||
if ($PathOrItem -is [string]) {
|
||||
@@ -205,12 +206,14 @@ if ($env:PLAN_ID) {
|
||||
|
||||
# Get-Item observes the link object even when its target is missing, unlike
|
||||
# Test-Path which follows the target. An active pointer that is a directory or
|
||||
# reparse point is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# a symlink is an unsafe/ambiguous selector and must terminate resolution;
|
||||
# falling through would silently select and expose the newest unrelated plan.
|
||||
# LinkType, not the ReparsePoint attribute: OneDrive Files On-Demand marks
|
||||
# every synced file as a reparse point, and such a pointer is a plain file
|
||||
# to every other route (#275).
|
||||
$activeItem = Get-Item -LiteralPath $activeFile -Force -ErrorAction SilentlyContinue
|
||||
if ($activeItem) {
|
||||
if ($activeItem.PSIsContainer -or
|
||||
(($activeItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0)) {
|
||||
if ($activeItem.PSIsContainer -or (Test-LinkedDirectory $activeItem)) {
|
||||
exit 0
|
||||
}
|
||||
# Get-Content -Raw returns $null for a zero-byte pointer; an empty pointer
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user