Compare commits

..
1 Commits
Author SHA1 Message Date
OthmanAdi a3e52a16d7 fix: v2.36.3 propagate resolve-plan-dir + set-active-plan to canonical skill
resolve-plan-dir.{sh,ps1} and set-active-plan.{sh,ps1} were added to
scripts/ in v2.36.0 but never reached skills/planning-with-files/scripts/
or the IDE mirror folders. Users installing via npx skills could not use
the parallel planning workflow because the required scripts were absent.

Adds all four scripts to the canonical skill location. Updates
sync-ide-folders.py SCRIPTS manifest to include them, and propagates to
all IDE mirrors via the sync tool (24 new files across 6 IDE folders).

Strengthens test_canonical_script_sync.py to cover all 8 user-facing
scripts (was 4), so this class of gap trips the regression test going
forward.

Documents resolve-plan-dir.sh and set-active-plan.sh in the canonical
SKILL.md Scripts section with usage descriptions and a parallel task
workflow example.
2026-05-01 21:19:29 +02:00
49 changed files with 1664 additions and 21 deletions
+1 -1
View File
@@ -9,7 +9,7 @@
"name": "planning-with-files",
"source": "./",
"description": "Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Now with hooks integration and multi-language support (Arabic, German, Spanish, Chinese).",
"version": "2.36.2"
"version": "2.36.3"
}
]
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "planning-with-files",
"version": "2.36.2",
"version": "2.36.3",
"description": "Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Works with Claude Code, Kiro, Clawd CLI, Gemini CLI, Cursor, Continue, Hermes, and 17+ AI coding assistants. Now with Arabic, German, Spanish, and Chinese (Simplified & Traditional) support.",
"author": {
"name": "OthmanAdi",
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "SD=\"${CODEBUDDY_PLUGIN_ROOT:-$HOME/.codebuddy/skills/planning-with-files}/scripts\"; powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File \"$SD/check-complete.ps1\" 2>/dev/null || sh \"$SD/check-complete.sh\""
metadata:
version: "2.36.2"
version: "2.36.3"
---
@@ -0,0 +1,44 @@
# planning-with-files: resolve active plan directory (PowerShell mirror).
#
# Resolution order matches scripts/resolve-plan-dir.sh:
# 1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
# 2. .\.planning\.active_plan content
# 3. Newest .\.planning\<dir>\ by LastWriteTime
# 4. Empty (legacy fallback to .\task_plan.md handled by caller)
param(
[string]$PlanRoot = (Join-Path (Get-Location) ".planning")
)
$activeFile = Join-Path $PlanRoot ".active_plan"
if ($env:PLAN_ID) {
$candidate = Join-Path $PlanRoot $env:PLAN_ID
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
if (Test-Path $activeFile) {
$planId = (Get-Content $activeFile -Raw).Trim()
if ($planId) {
$candidate = Join-Path $PlanRoot $planId
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
}
if (Test-Path $PlanRoot -PathType Container) {
$latest = Get-ChildItem -Path $PlanRoot -Directory |
Where-Object { -not $_.Name.StartsWith('.') } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($latest) {
Write-Output $latest.FullName
}
}
exit 0
@@ -0,0 +1,76 @@
#!/bin/sh
# planning-with-files: resolve active plan directory.
#
# Resolution order:
# 1. $PLAN_ID env var → ./.planning/$PLAN_ID/ if exists
# 2. ./.planning/.active_plan content → matching dir if exists
# 3. Newest ./.planning/<dir>/ by mtime
# 4. Otherwise empty stdout (caller falls back to legacy ./task_plan.md)
#
# Always exits 0. Never errors out the agent loop.
#
# Usage:
# PLAN_DIR="$(sh scripts/resolve-plan-dir.sh)"
# PLAN_FILE="${PLAN_DIR:+$PLAN_DIR/}task_plan.md"
set -u
PLAN_ROOT="${1:-${PWD}/.planning}"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
resolve_from_env() {
plan_id="${PLAN_ID:-}"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_from_active_file() {
[ -f "${ACTIVE_FILE}" ] || return 1
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_latest_dir() {
[ -d "${PLAN_ROOT}" ] || return 1
# Portable newest-mtime selector. Avoid `ls -t` BSD/GNU drift.
# Only consider dirs that contain task_plan.md — skips system dirs like sessions/.
latest=""
latest_mtime=0
for entry in "${PLAN_ROOT}"/*/; do
[ -d "${entry}" ] || continue
# Strip trailing slash
clean="${entry%/}"
# Skip hidden dirs
case "$(basename "${clean}")" in
.*) continue ;;
esac
# Skip dirs that are not plan dirs
[ -f "${clean}/task_plan.md" ] || continue
mtime="$(date -r "${clean}" +%s 2>/dev/null || stat -c '%Y' "${clean}" 2>/dev/null || echo 0)"
if [ "${mtime}" -gt "${latest_mtime}" ] 2>/dev/null; then
latest_mtime="${mtime}"
latest="${clean}"
fi
done
if [ -n "${latest}" ]; then
printf "%s\n" "${latest}"
return 0
fi
return 1
}
if resolve_from_env; then exit 0; fi
if resolve_from_active_file; then exit 0; fi
if resolve_latest_dir; then exit 0; fi
exit 0
@@ -0,0 +1,50 @@
# planning-with-files: set or display the active plan pointer (PowerShell).
#
# Usage:
# .\set-active-plan.ps1 <plan_id> — pin .planning\.active_plan to plan_id
# .\set-active-plan.ps1 — print the current active plan (if any)
param(
[string]$PlanId = ""
)
$PlanRoot = Join-Path (Get-Location) ".planning"
$ActiveFile = Join-Path $PlanRoot ".active_plan"
if ($PlanId -eq "") {
if (Test-Path $ActiveFile) {
$current = (Get-Content $ActiveFile -Raw -Encoding UTF8).Trim()
$planDir = Join-Path $PlanRoot $current
if ($current -ne "" -and (Test-Path $planDir)) {
Write-Output "Active plan: $current"
Write-Output "Path: $planDir"
} elseif ($current -ne "") {
Write-Output "Active plan pointer: $current (directory not found — stale pointer)"
} else {
Write-Output "No active plan set."
}
} else {
Write-Output "No active plan set."
}
exit 0
}
$PlanDir = Join-Path $PlanRoot $PlanId
if (-not (Test-Path $PlanDir)) {
Write-Error "Error: plan directory not found: $PlanDir"
Write-Error "Run: init-session.sh `"$PlanId`" to create it, or check .planning\ for available plans."
exit 1
}
if (-not (Test-Path $PlanRoot)) {
New-Item -ItemType Directory -Path $PlanRoot -Force | Out-Null
}
Set-Content -Path $ActiveFile -Value $PlanId -Encoding UTF8 -NoNewline
Write-Output "Active plan set to: $PlanId"
Write-Output "Path: $PlanDir"
Write-Output ""
Write-Output "To pin this terminal session only:"
Write-Output "`$env:PLAN_ID = '$PlanId'"
@@ -0,0 +1,50 @@
#!/bin/sh
# planning-with-files: set or display the active plan pointer.
#
# Usage:
# set-active-plan.sh <plan_id> — pin .planning/.active_plan to plan_id
# set-active-plan.sh — print the current active plan (if any)
#
# The active plan is stored in .planning/.active_plan and is read by
# resolve-plan-dir.sh when no $PLAN_ID env var is set.
set -e
PLAN_ROOT="${PWD}/.planning"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
# No args → show current active plan
if [ "${1:-}" = "" ]; then
if [ -f "${ACTIVE_FILE}" ]; then
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
if [ -n "${plan_id}" ] && [ -d "${PLAN_ROOT}/${plan_id}" ]; then
echo "Active plan: ${plan_id}"
echo "Path: ${PLAN_ROOT}/${plan_id}"
elif [ -n "${plan_id}" ]; then
echo "Active plan pointer: ${plan_id} (directory not found — stale pointer)"
else
echo "No active plan set."
fi
else
echo "No active plan set."
fi
exit 0
fi
PLAN_ID="$1"
PLAN_DIR="${PLAN_ROOT}/${PLAN_ID}"
if [ ! -d "${PLAN_DIR}" ]; then
echo "Error: plan directory not found: ${PLAN_DIR}" >&2
echo "Run: init-session.sh \"${PLAN_ID}\" to create it, or check .planning/ for available plans." >&2
exit 1
fi
mkdir -p "${PLAN_ROOT}"
printf "%s\n" "${PLAN_ID}" > "${ACTIVE_FILE}"
echo "Active plan set to: ${PLAN_ID}"
echo "Path: ${PLAN_DIR}"
echo ""
echo "To pin this terminal session only:"
echo " export PLAN_ID=${PLAN_ID}"
+1 -1
View File
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "SD=\"${CODEX_SKILL_ROOT:-$HOME/.codex/skills/planning-with-files}/scripts\"; powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File \"$SD/check-complete.ps1\" 2>/dev/null || sh \"$SD/check-complete.sh\""
metadata:
version: "2.36.2"
version: "2.36.3"
---
@@ -0,0 +1,44 @@
# planning-with-files: resolve active plan directory (PowerShell mirror).
#
# Resolution order matches scripts/resolve-plan-dir.sh:
# 1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
# 2. .\.planning\.active_plan content
# 3. Newest .\.planning\<dir>\ by LastWriteTime
# 4. Empty (legacy fallback to .\task_plan.md handled by caller)
param(
[string]$PlanRoot = (Join-Path (Get-Location) ".planning")
)
$activeFile = Join-Path $PlanRoot ".active_plan"
if ($env:PLAN_ID) {
$candidate = Join-Path $PlanRoot $env:PLAN_ID
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
if (Test-Path $activeFile) {
$planId = (Get-Content $activeFile -Raw).Trim()
if ($planId) {
$candidate = Join-Path $PlanRoot $planId
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
}
if (Test-Path $PlanRoot -PathType Container) {
$latest = Get-ChildItem -Path $PlanRoot -Directory |
Where-Object { -not $_.Name.StartsWith('.') } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($latest) {
Write-Output $latest.FullName
}
}
exit 0
@@ -0,0 +1,76 @@
#!/bin/sh
# planning-with-files: resolve active plan directory.
#
# Resolution order:
# 1. $PLAN_ID env var → ./.planning/$PLAN_ID/ if exists
# 2. ./.planning/.active_plan content → matching dir if exists
# 3. Newest ./.planning/<dir>/ by mtime
# 4. Otherwise empty stdout (caller falls back to legacy ./task_plan.md)
#
# Always exits 0. Never errors out the agent loop.
#
# Usage:
# PLAN_DIR="$(sh scripts/resolve-plan-dir.sh)"
# PLAN_FILE="${PLAN_DIR:+$PLAN_DIR/}task_plan.md"
set -u
PLAN_ROOT="${1:-${PWD}/.planning}"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
resolve_from_env() {
plan_id="${PLAN_ID:-}"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_from_active_file() {
[ -f "${ACTIVE_FILE}" ] || return 1
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_latest_dir() {
[ -d "${PLAN_ROOT}" ] || return 1
# Portable newest-mtime selector. Avoid `ls -t` BSD/GNU drift.
# Only consider dirs that contain task_plan.md — skips system dirs like sessions/.
latest=""
latest_mtime=0
for entry in "${PLAN_ROOT}"/*/; do
[ -d "${entry}" ] || continue
# Strip trailing slash
clean="${entry%/}"
# Skip hidden dirs
case "$(basename "${clean}")" in
.*) continue ;;
esac
# Skip dirs that are not plan dirs
[ -f "${clean}/task_plan.md" ] || continue
mtime="$(date -r "${clean}" +%s 2>/dev/null || stat -c '%Y' "${clean}" 2>/dev/null || echo 0)"
if [ "${mtime}" -gt "${latest_mtime}" ] 2>/dev/null; then
latest_mtime="${mtime}"
latest="${clean}"
fi
done
if [ -n "${latest}" ]; then
printf "%s\n" "${latest}"
return 0
fi
return 1
}
if resolve_from_env; then exit 0; fi
if resolve_from_active_file; then exit 0; fi
if resolve_latest_dir; then exit 0; fi
exit 0
@@ -0,0 +1,50 @@
# planning-with-files: set or display the active plan pointer (PowerShell).
#
# Usage:
# .\set-active-plan.ps1 <plan_id> — pin .planning\.active_plan to plan_id
# .\set-active-plan.ps1 — print the current active plan (if any)
param(
[string]$PlanId = ""
)
$PlanRoot = Join-Path (Get-Location) ".planning"
$ActiveFile = Join-Path $PlanRoot ".active_plan"
if ($PlanId -eq "") {
if (Test-Path $ActiveFile) {
$current = (Get-Content $ActiveFile -Raw -Encoding UTF8).Trim()
$planDir = Join-Path $PlanRoot $current
if ($current -ne "" -and (Test-Path $planDir)) {
Write-Output "Active plan: $current"
Write-Output "Path: $planDir"
} elseif ($current -ne "") {
Write-Output "Active plan pointer: $current (directory not found — stale pointer)"
} else {
Write-Output "No active plan set."
}
} else {
Write-Output "No active plan set."
}
exit 0
}
$PlanDir = Join-Path $PlanRoot $PlanId
if (-not (Test-Path $PlanDir)) {
Write-Error "Error: plan directory not found: $PlanDir"
Write-Error "Run: init-session.sh `"$PlanId`" to create it, or check .planning\ for available plans."
exit 1
}
if (-not (Test-Path $PlanRoot)) {
New-Item -ItemType Directory -Path $PlanRoot -Force | Out-Null
}
Set-Content -Path $ActiveFile -Value $PlanId -Encoding UTF8 -NoNewline
Write-Output "Active plan set to: $PlanId"
Write-Output "Path: $PlanDir"
Write-Output ""
Write-Output "To pin this terminal session only:"
Write-Output "`$env:PLAN_ID = '$PlanId'"
@@ -0,0 +1,50 @@
#!/bin/sh
# planning-with-files: set or display the active plan pointer.
#
# Usage:
# set-active-plan.sh <plan_id> — pin .planning/.active_plan to plan_id
# set-active-plan.sh — print the current active plan (if any)
#
# The active plan is stored in .planning/.active_plan and is read by
# resolve-plan-dir.sh when no $PLAN_ID env var is set.
set -e
PLAN_ROOT="${PWD}/.planning"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
# No args → show current active plan
if [ "${1:-}" = "" ]; then
if [ -f "${ACTIVE_FILE}" ]; then
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
if [ -n "${plan_id}" ] && [ -d "${PLAN_ROOT}/${plan_id}" ]; then
echo "Active plan: ${plan_id}"
echo "Path: ${PLAN_ROOT}/${plan_id}"
elif [ -n "${plan_id}" ]; then
echo "Active plan pointer: ${plan_id} (directory not found — stale pointer)"
else
echo "No active plan set."
fi
else
echo "No active plan set."
fi
exit 0
fi
PLAN_ID="$1"
PLAN_DIR="${PLAN_ROOT}/${PLAN_ID}"
if [ ! -d "${PLAN_DIR}" ]; then
echo "Error: plan directory not found: ${PLAN_DIR}" >&2
echo "Run: init-session.sh \"${PLAN_ID}\" to create it, or check .planning/ for available plans." >&2
exit 1
fi
mkdir -p "${PLAN_ROOT}"
printf "%s\n" "${PLAN_ID}" > "${ACTIVE_FILE}"
echo "Active plan set to: ${PLAN_ID}"
echo "Path: ${PLAN_DIR}"
echo ""
echo "To pin this terminal session only:"
echo " export PLAN_ID=${PLAN_ID}"
@@ -0,0 +1,44 @@
# planning-with-files: resolve active plan directory (PowerShell mirror).
#
# Resolution order matches scripts/resolve-plan-dir.sh:
# 1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
# 2. .\.planning\.active_plan content
# 3. Newest .\.planning\<dir>\ by LastWriteTime
# 4. Empty (legacy fallback to .\task_plan.md handled by caller)
param(
[string]$PlanRoot = (Join-Path (Get-Location) ".planning")
)
$activeFile = Join-Path $PlanRoot ".active_plan"
if ($env:PLAN_ID) {
$candidate = Join-Path $PlanRoot $env:PLAN_ID
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
if (Test-Path $activeFile) {
$planId = (Get-Content $activeFile -Raw).Trim()
if ($planId) {
$candidate = Join-Path $PlanRoot $planId
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
}
if (Test-Path $PlanRoot -PathType Container) {
$latest = Get-ChildItem -Path $PlanRoot -Directory |
Where-Object { -not $_.Name.StartsWith('.') } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($latest) {
Write-Output $latest.FullName
}
}
exit 0
@@ -0,0 +1,76 @@
#!/bin/sh
# planning-with-files: resolve active plan directory.
#
# Resolution order:
# 1. $PLAN_ID env var → ./.planning/$PLAN_ID/ if exists
# 2. ./.planning/.active_plan content → matching dir if exists
# 3. Newest ./.planning/<dir>/ by mtime
# 4. Otherwise empty stdout (caller falls back to legacy ./task_plan.md)
#
# Always exits 0. Never errors out the agent loop.
#
# Usage:
# PLAN_DIR="$(sh scripts/resolve-plan-dir.sh)"
# PLAN_FILE="${PLAN_DIR:+$PLAN_DIR/}task_plan.md"
set -u
PLAN_ROOT="${1:-${PWD}/.planning}"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
resolve_from_env() {
plan_id="${PLAN_ID:-}"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_from_active_file() {
[ -f "${ACTIVE_FILE}" ] || return 1
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_latest_dir() {
[ -d "${PLAN_ROOT}" ] || return 1
# Portable newest-mtime selector. Avoid `ls -t` BSD/GNU drift.
# Only consider dirs that contain task_plan.md — skips system dirs like sessions/.
latest=""
latest_mtime=0
for entry in "${PLAN_ROOT}"/*/; do
[ -d "${entry}" ] || continue
# Strip trailing slash
clean="${entry%/}"
# Skip hidden dirs
case "$(basename "${clean}")" in
.*) continue ;;
esac
# Skip dirs that are not plan dirs
[ -f "${clean}/task_plan.md" ] || continue
mtime="$(date -r "${clean}" +%s 2>/dev/null || stat -c '%Y' "${clean}" 2>/dev/null || echo 0)"
if [ "${mtime}" -gt "${latest_mtime}" ] 2>/dev/null; then
latest_mtime="${mtime}"
latest="${clean}"
fi
done
if [ -n "${latest}" ]; then
printf "%s\n" "${latest}"
return 0
fi
return 1
}
if resolve_from_env; then exit 0; fi
if resolve_from_active_file; then exit 0; fi
if resolve_latest_dir; then exit 0; fi
exit 0
@@ -0,0 +1,50 @@
# planning-with-files: set or display the active plan pointer (PowerShell).
#
# Usage:
# .\set-active-plan.ps1 <plan_id> — pin .planning\.active_plan to plan_id
# .\set-active-plan.ps1 — print the current active plan (if any)
param(
[string]$PlanId = ""
)
$PlanRoot = Join-Path (Get-Location) ".planning"
$ActiveFile = Join-Path $PlanRoot ".active_plan"
if ($PlanId -eq "") {
if (Test-Path $ActiveFile) {
$current = (Get-Content $ActiveFile -Raw -Encoding UTF8).Trim()
$planDir = Join-Path $PlanRoot $current
if ($current -ne "" -and (Test-Path $planDir)) {
Write-Output "Active plan: $current"
Write-Output "Path: $planDir"
} elseif ($current -ne "") {
Write-Output "Active plan pointer: $current (directory not found — stale pointer)"
} else {
Write-Output "No active plan set."
}
} else {
Write-Output "No active plan set."
}
exit 0
}
$PlanDir = Join-Path $PlanRoot $PlanId
if (-not (Test-Path $PlanDir)) {
Write-Error "Error: plan directory not found: $PlanDir"
Write-Error "Run: init-session.sh `"$PlanId`" to create it, or check .planning\ for available plans."
exit 1
}
if (-not (Test-Path $PlanRoot)) {
New-Item -ItemType Directory -Path $PlanRoot -Force | Out-Null
}
Set-Content -Path $ActiveFile -Value $PlanId -Encoding UTF8 -NoNewline
Write-Output "Active plan set to: $PlanId"
Write-Output "Path: $PlanDir"
Write-Output ""
Write-Output "To pin this terminal session only:"
Write-Output "`$env:PLAN_ID = '$PlanId'"
@@ -0,0 +1,50 @@
#!/bin/sh
# planning-with-files: set or display the active plan pointer.
#
# Usage:
# set-active-plan.sh <plan_id> — pin .planning/.active_plan to plan_id
# set-active-plan.sh — print the current active plan (if any)
#
# The active plan is stored in .planning/.active_plan and is read by
# resolve-plan-dir.sh when no $PLAN_ID env var is set.
set -e
PLAN_ROOT="${PWD}/.planning"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
# No args → show current active plan
if [ "${1:-}" = "" ]; then
if [ -f "${ACTIVE_FILE}" ]; then
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
if [ -n "${plan_id}" ] && [ -d "${PLAN_ROOT}/${plan_id}" ]; then
echo "Active plan: ${plan_id}"
echo "Path: ${PLAN_ROOT}/${plan_id}"
elif [ -n "${plan_id}" ]; then
echo "Active plan pointer: ${plan_id} (directory not found — stale pointer)"
else
echo "No active plan set."
fi
else
echo "No active plan set."
fi
exit 0
fi
PLAN_ID="$1"
PLAN_DIR="${PLAN_ROOT}/${PLAN_ID}"
if [ ! -d "${PLAN_DIR}" ]; then
echo "Error: plan directory not found: ${PLAN_DIR}" >&2
echo "Run: init-session.sh \"${PLAN_ID}\" to create it, or check .planning/ for available plans." >&2
exit 1
fi
mkdir -p "${PLAN_ROOT}"
printf "%s\n" "${PLAN_ID}" > "${ACTIVE_FILE}"
echo "Active plan set to: ${PLAN_ID}"
echo "Path: ${PLAN_DIR}"
echo ""
echo "To pin this terminal session only:"
echo " export PLAN_ID=${PLAN_ID}"
+1 -1
View File
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "SD=\"${CURSOR_SKILL_ROOT:-.cursor/skills/planning-with-files}/scripts\"; powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File \"$SD/check-complete.ps1\" 2>/dev/null || sh \"$SD/check-complete.sh\""
metadata:
version: "2.36.2"
version: "2.36.3"
---
+1 -1
View File
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "SD=\"${FACTORY_PROJECT_DIR:-.factory/skills/planning-with-files}/scripts\"; sh \"$SD/check-complete.sh\" 2>/dev/null || true"
metadata:
version: "2.36.2"
version: "2.36.3"
---
# Planning with Files
@@ -0,0 +1,44 @@
# planning-with-files: resolve active plan directory (PowerShell mirror).
#
# Resolution order matches scripts/resolve-plan-dir.sh:
# 1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
# 2. .\.planning\.active_plan content
# 3. Newest .\.planning\<dir>\ by LastWriteTime
# 4. Empty (legacy fallback to .\task_plan.md handled by caller)
param(
[string]$PlanRoot = (Join-Path (Get-Location) ".planning")
)
$activeFile = Join-Path $PlanRoot ".active_plan"
if ($env:PLAN_ID) {
$candidate = Join-Path $PlanRoot $env:PLAN_ID
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
if (Test-Path $activeFile) {
$planId = (Get-Content $activeFile -Raw).Trim()
if ($planId) {
$candidate = Join-Path $PlanRoot $planId
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
}
if (Test-Path $PlanRoot -PathType Container) {
$latest = Get-ChildItem -Path $PlanRoot -Directory |
Where-Object { -not $_.Name.StartsWith('.') } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($latest) {
Write-Output $latest.FullName
}
}
exit 0
@@ -0,0 +1,76 @@
#!/bin/sh
# planning-with-files: resolve active plan directory.
#
# Resolution order:
# 1. $PLAN_ID env var → ./.planning/$PLAN_ID/ if exists
# 2. ./.planning/.active_plan content → matching dir if exists
# 3. Newest ./.planning/<dir>/ by mtime
# 4. Otherwise empty stdout (caller falls back to legacy ./task_plan.md)
#
# Always exits 0. Never errors out the agent loop.
#
# Usage:
# PLAN_DIR="$(sh scripts/resolve-plan-dir.sh)"
# PLAN_FILE="${PLAN_DIR:+$PLAN_DIR/}task_plan.md"
set -u
PLAN_ROOT="${1:-${PWD}/.planning}"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
resolve_from_env() {
plan_id="${PLAN_ID:-}"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_from_active_file() {
[ -f "${ACTIVE_FILE}" ] || return 1
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_latest_dir() {
[ -d "${PLAN_ROOT}" ] || return 1
# Portable newest-mtime selector. Avoid `ls -t` BSD/GNU drift.
# Only consider dirs that contain task_plan.md — skips system dirs like sessions/.
latest=""
latest_mtime=0
for entry in "${PLAN_ROOT}"/*/; do
[ -d "${entry}" ] || continue
# Strip trailing slash
clean="${entry%/}"
# Skip hidden dirs
case "$(basename "${clean}")" in
.*) continue ;;
esac
# Skip dirs that are not plan dirs
[ -f "${clean}/task_plan.md" ] || continue
mtime="$(date -r "${clean}" +%s 2>/dev/null || stat -c '%Y' "${clean}" 2>/dev/null || echo 0)"
if [ "${mtime}" -gt "${latest_mtime}" ] 2>/dev/null; then
latest_mtime="${mtime}"
latest="${clean}"
fi
done
if [ -n "${latest}" ]; then
printf "%s\n" "${latest}"
return 0
fi
return 1
}
if resolve_from_env; then exit 0; fi
if resolve_from_active_file; then exit 0; fi
if resolve_latest_dir; then exit 0; fi
exit 0
@@ -0,0 +1,50 @@
# planning-with-files: set or display the active plan pointer (PowerShell).
#
# Usage:
# .\set-active-plan.ps1 <plan_id> — pin .planning\.active_plan to plan_id
# .\set-active-plan.ps1 — print the current active plan (if any)
param(
[string]$PlanId = ""
)
$PlanRoot = Join-Path (Get-Location) ".planning"
$ActiveFile = Join-Path $PlanRoot ".active_plan"
if ($PlanId -eq "") {
if (Test-Path $ActiveFile) {
$current = (Get-Content $ActiveFile -Raw -Encoding UTF8).Trim()
$planDir = Join-Path $PlanRoot $current
if ($current -ne "" -and (Test-Path $planDir)) {
Write-Output "Active plan: $current"
Write-Output "Path: $planDir"
} elseif ($current -ne "") {
Write-Output "Active plan pointer: $current (directory not found — stale pointer)"
} else {
Write-Output "No active plan set."
}
} else {
Write-Output "No active plan set."
}
exit 0
}
$PlanDir = Join-Path $PlanRoot $PlanId
if (-not (Test-Path $PlanDir)) {
Write-Error "Error: plan directory not found: $PlanDir"
Write-Error "Run: init-session.sh `"$PlanId`" to create it, or check .planning\ for available plans."
exit 1
}
if (-not (Test-Path $PlanRoot)) {
New-Item -ItemType Directory -Path $PlanRoot -Force | Out-Null
}
Set-Content -Path $ActiveFile -Value $PlanId -Encoding UTF8 -NoNewline
Write-Output "Active plan set to: $PlanId"
Write-Output "Path: $PlanDir"
Write-Output ""
Write-Output "To pin this terminal session only:"
Write-Output "`$env:PLAN_ID = '$PlanId'"
@@ -0,0 +1,50 @@
#!/bin/sh
# planning-with-files: set or display the active plan pointer.
#
# Usage:
# set-active-plan.sh <plan_id> — pin .planning/.active_plan to plan_id
# set-active-plan.sh — print the current active plan (if any)
#
# The active plan is stored in .planning/.active_plan and is read by
# resolve-plan-dir.sh when no $PLAN_ID env var is set.
set -e
PLAN_ROOT="${PWD}/.planning"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
# No args → show current active plan
if [ "${1:-}" = "" ]; then
if [ -f "${ACTIVE_FILE}" ]; then
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
if [ -n "${plan_id}" ] && [ -d "${PLAN_ROOT}/${plan_id}" ]; then
echo "Active plan: ${plan_id}"
echo "Path: ${PLAN_ROOT}/${plan_id}"
elif [ -n "${plan_id}" ]; then
echo "Active plan pointer: ${plan_id} (directory not found — stale pointer)"
else
echo "No active plan set."
fi
else
echo "No active plan set."
fi
exit 0
fi
PLAN_ID="$1"
PLAN_DIR="${PLAN_ROOT}/${PLAN_ID}"
if [ ! -d "${PLAN_DIR}" ]; then
echo "Error: plan directory not found: ${PLAN_DIR}" >&2
echo "Run: init-session.sh \"${PLAN_ID}\" to create it, or check .planning/ for available plans." >&2
exit 1
fi
mkdir -p "${PLAN_ROOT}"
printf "%s\n" "${PLAN_ID}" > "${ACTIVE_FILE}"
echo "Active plan set to: ${PLAN_ID}"
echo "Path: ${PLAN_DIR}"
echo ""
echo "To pin this terminal session only:"
echo " export PLAN_ID=${PLAN_ID}"
@@ -0,0 +1,44 @@
# planning-with-files: resolve active plan directory (PowerShell mirror).
#
# Resolution order matches scripts/resolve-plan-dir.sh:
# 1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
# 2. .\.planning\.active_plan content
# 3. Newest .\.planning\<dir>\ by LastWriteTime
# 4. Empty (legacy fallback to .\task_plan.md handled by caller)
param(
[string]$PlanRoot = (Join-Path (Get-Location) ".planning")
)
$activeFile = Join-Path $PlanRoot ".active_plan"
if ($env:PLAN_ID) {
$candidate = Join-Path $PlanRoot $env:PLAN_ID
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
if (Test-Path $activeFile) {
$planId = (Get-Content $activeFile -Raw).Trim()
if ($planId) {
$candidate = Join-Path $PlanRoot $planId
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
}
if (Test-Path $PlanRoot -PathType Container) {
$latest = Get-ChildItem -Path $PlanRoot -Directory |
Where-Object { -not $_.Name.StartsWith('.') } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($latest) {
Write-Output $latest.FullName
}
}
exit 0
@@ -0,0 +1,76 @@
#!/bin/sh
# planning-with-files: resolve active plan directory.
#
# Resolution order:
# 1. $PLAN_ID env var → ./.planning/$PLAN_ID/ if exists
# 2. ./.planning/.active_plan content → matching dir if exists
# 3. Newest ./.planning/<dir>/ by mtime
# 4. Otherwise empty stdout (caller falls back to legacy ./task_plan.md)
#
# Always exits 0. Never errors out the agent loop.
#
# Usage:
# PLAN_DIR="$(sh scripts/resolve-plan-dir.sh)"
# PLAN_FILE="${PLAN_DIR:+$PLAN_DIR/}task_plan.md"
set -u
PLAN_ROOT="${1:-${PWD}/.planning}"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
resolve_from_env() {
plan_id="${PLAN_ID:-}"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_from_active_file() {
[ -f "${ACTIVE_FILE}" ] || return 1
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_latest_dir() {
[ -d "${PLAN_ROOT}" ] || return 1
# Portable newest-mtime selector. Avoid `ls -t` BSD/GNU drift.
# Only consider dirs that contain task_plan.md — skips system dirs like sessions/.
latest=""
latest_mtime=0
for entry in "${PLAN_ROOT}"/*/; do
[ -d "${entry}" ] || continue
# Strip trailing slash
clean="${entry%/}"
# Skip hidden dirs
case "$(basename "${clean}")" in
.*) continue ;;
esac
# Skip dirs that are not plan dirs
[ -f "${clean}/task_plan.md" ] || continue
mtime="$(date -r "${clean}" +%s 2>/dev/null || stat -c '%Y' "${clean}" 2>/dev/null || echo 0)"
if [ "${mtime}" -gt "${latest_mtime}" ] 2>/dev/null; then
latest_mtime="${mtime}"
latest="${clean}"
fi
done
if [ -n "${latest}" ]; then
printf "%s\n" "${latest}"
return 0
fi
return 1
}
if resolve_from_env; then exit 0; fi
if resolve_from_active_file; then exit 0; fi
if resolve_latest_dir; then exit 0; fi
exit 0
@@ -0,0 +1,50 @@
# planning-with-files: set or display the active plan pointer (PowerShell).
#
# Usage:
# .\set-active-plan.ps1 <plan_id> — pin .planning\.active_plan to plan_id
# .\set-active-plan.ps1 — print the current active plan (if any)
param(
[string]$PlanId = ""
)
$PlanRoot = Join-Path (Get-Location) ".planning"
$ActiveFile = Join-Path $PlanRoot ".active_plan"
if ($PlanId -eq "") {
if (Test-Path $ActiveFile) {
$current = (Get-Content $ActiveFile -Raw -Encoding UTF8).Trim()
$planDir = Join-Path $PlanRoot $current
if ($current -ne "" -and (Test-Path $planDir)) {
Write-Output "Active plan: $current"
Write-Output "Path: $planDir"
} elseif ($current -ne "") {
Write-Output "Active plan pointer: $current (directory not found — stale pointer)"
} else {
Write-Output "No active plan set."
}
} else {
Write-Output "No active plan set."
}
exit 0
}
$PlanDir = Join-Path $PlanRoot $PlanId
if (-not (Test-Path $PlanDir)) {
Write-Error "Error: plan directory not found: $PlanDir"
Write-Error "Run: init-session.sh `"$PlanId`" to create it, or check .planning\ for available plans."
exit 1
}
if (-not (Test-Path $PlanRoot)) {
New-Item -ItemType Directory -Path $PlanRoot -Force | Out-Null
}
Set-Content -Path $ActiveFile -Value $PlanId -Encoding UTF8 -NoNewline
Write-Output "Active plan set to: $PlanId"
Write-Output "Path: $PlanDir"
Write-Output ""
Write-Output "To pin this terminal session only:"
Write-Output "`$env:PLAN_ID = '$PlanId'"
@@ -0,0 +1,50 @@
#!/bin/sh
# planning-with-files: set or display the active plan pointer.
#
# Usage:
# set-active-plan.sh <plan_id> — pin .planning/.active_plan to plan_id
# set-active-plan.sh — print the current active plan (if any)
#
# The active plan is stored in .planning/.active_plan and is read by
# resolve-plan-dir.sh when no $PLAN_ID env var is set.
set -e
PLAN_ROOT="${PWD}/.planning"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
# No args → show current active plan
if [ "${1:-}" = "" ]; then
if [ -f "${ACTIVE_FILE}" ]; then
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
if [ -n "${plan_id}" ] && [ -d "${PLAN_ROOT}/${plan_id}" ]; then
echo "Active plan: ${plan_id}"
echo "Path: ${PLAN_ROOT}/${plan_id}"
elif [ -n "${plan_id}" ]; then
echo "Active plan pointer: ${plan_id} (directory not found — stale pointer)"
else
echo "No active plan set."
fi
else
echo "No active plan set."
fi
exit 0
fi
PLAN_ID="$1"
PLAN_DIR="${PLAN_ROOT}/${PLAN_ID}"
if [ ! -d "${PLAN_DIR}" ]; then
echo "Error: plan directory not found: ${PLAN_DIR}" >&2
echo "Run: init-session.sh \"${PLAN_ID}\" to create it, or check .planning/ for available plans." >&2
exit 1
fi
mkdir -p "${PLAN_ROOT}"
printf "%s\n" "${PLAN_ID}" > "${ACTIVE_FILE}"
echo "Active plan set to: ${PLAN_ID}"
echo "Path: ${PLAN_DIR}"
echo ""
echo "To pin this terminal session only:"
echo " export PLAN_ID=${PLAN_ID}"
+1 -1
View File
@@ -2,7 +2,7 @@
name: planning-with-files
description: Implements Manus-style file-based planning to organize and track progress on complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when asked to plan out, break down, or organize a multi-step project, research task, or any work requiring 5+ tool calls. Hermes adaptation with minimal notes.
metadata:
version: "2.36.2"
version: "2.36.3"
---
> Hermes note: lifecycle automation for this skill is provided by the Hermes adapter plugin in `.hermes/plugins/planning-with-files/`.
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "SD=\"$HOME/.mastracode/skills/planning-with-files/scripts\"; [ -f \"$SD/check-complete.sh\" ] || SD=\".mastracode/skills/planning-with-files/scripts\"; powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File \"$SD/check-complete.ps1\" 2>/dev/null || sh \"$SD/check-complete.sh\""
metadata:
version: "2.36.2"
version: "2.36.3"
---
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "SD=\"${OPENCODE_SKILL_ROOT:-$HOME/.config/opencode/skills/planning-with-files}/scripts\"; powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File \"$SD/check-complete.ps1\" 2>/dev/null || sh \"$SD/check-complete.sh\""
metadata:
version: "2.36.2"
version: "2.36.3"
---
@@ -0,0 +1,44 @@
# planning-with-files: resolve active plan directory (PowerShell mirror).
#
# Resolution order matches scripts/resolve-plan-dir.sh:
# 1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
# 2. .\.planning\.active_plan content
# 3. Newest .\.planning\<dir>\ by LastWriteTime
# 4. Empty (legacy fallback to .\task_plan.md handled by caller)
param(
[string]$PlanRoot = (Join-Path (Get-Location) ".planning")
)
$activeFile = Join-Path $PlanRoot ".active_plan"
if ($env:PLAN_ID) {
$candidate = Join-Path $PlanRoot $env:PLAN_ID
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
if (Test-Path $activeFile) {
$planId = (Get-Content $activeFile -Raw).Trim()
if ($planId) {
$candidate = Join-Path $PlanRoot $planId
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
}
if (Test-Path $PlanRoot -PathType Container) {
$latest = Get-ChildItem -Path $PlanRoot -Directory |
Where-Object { -not $_.Name.StartsWith('.') } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($latest) {
Write-Output $latest.FullName
}
}
exit 0
@@ -0,0 +1,76 @@
#!/bin/sh
# planning-with-files: resolve active plan directory.
#
# Resolution order:
# 1. $PLAN_ID env var → ./.planning/$PLAN_ID/ if exists
# 2. ./.planning/.active_plan content → matching dir if exists
# 3. Newest ./.planning/<dir>/ by mtime
# 4. Otherwise empty stdout (caller falls back to legacy ./task_plan.md)
#
# Always exits 0. Never errors out the agent loop.
#
# Usage:
# PLAN_DIR="$(sh scripts/resolve-plan-dir.sh)"
# PLAN_FILE="${PLAN_DIR:+$PLAN_DIR/}task_plan.md"
set -u
PLAN_ROOT="${1:-${PWD}/.planning}"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
resolve_from_env() {
plan_id="${PLAN_ID:-}"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_from_active_file() {
[ -f "${ACTIVE_FILE}" ] || return 1
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_latest_dir() {
[ -d "${PLAN_ROOT}" ] || return 1
# Portable newest-mtime selector. Avoid `ls -t` BSD/GNU drift.
# Only consider dirs that contain task_plan.md — skips system dirs like sessions/.
latest=""
latest_mtime=0
for entry in "${PLAN_ROOT}"/*/; do
[ -d "${entry}" ] || continue
# Strip trailing slash
clean="${entry%/}"
# Skip hidden dirs
case "$(basename "${clean}")" in
.*) continue ;;
esac
# Skip dirs that are not plan dirs
[ -f "${clean}/task_plan.md" ] || continue
mtime="$(date -r "${clean}" +%s 2>/dev/null || stat -c '%Y' "${clean}" 2>/dev/null || echo 0)"
if [ "${mtime}" -gt "${latest_mtime}" ] 2>/dev/null; then
latest_mtime="${mtime}"
latest="${clean}"
fi
done
if [ -n "${latest}" ]; then
printf "%s\n" "${latest}"
return 0
fi
return 1
}
if resolve_from_env; then exit 0; fi
if resolve_from_active_file; then exit 0; fi
if resolve_latest_dir; then exit 0; fi
exit 0
@@ -0,0 +1,50 @@
# planning-with-files: set or display the active plan pointer (PowerShell).
#
# Usage:
# .\set-active-plan.ps1 <plan_id> — pin .planning\.active_plan to plan_id
# .\set-active-plan.ps1 — print the current active plan (if any)
param(
[string]$PlanId = ""
)
$PlanRoot = Join-Path (Get-Location) ".planning"
$ActiveFile = Join-Path $PlanRoot ".active_plan"
if ($PlanId -eq "") {
if (Test-Path $ActiveFile) {
$current = (Get-Content $ActiveFile -Raw -Encoding UTF8).Trim()
$planDir = Join-Path $PlanRoot $current
if ($current -ne "" -and (Test-Path $planDir)) {
Write-Output "Active plan: $current"
Write-Output "Path: $planDir"
} elseif ($current -ne "") {
Write-Output "Active plan pointer: $current (directory not found — stale pointer)"
} else {
Write-Output "No active plan set."
}
} else {
Write-Output "No active plan set."
}
exit 0
}
$PlanDir = Join-Path $PlanRoot $PlanId
if (-not (Test-Path $PlanDir)) {
Write-Error "Error: plan directory not found: $PlanDir"
Write-Error "Run: init-session.sh `"$PlanId`" to create it, or check .planning\ for available plans."
exit 1
}
if (-not (Test-Path $PlanRoot)) {
New-Item -ItemType Directory -Path $PlanRoot -Force | Out-Null
}
Set-Content -Path $ActiveFile -Value $PlanId -Encoding UTF8 -NoNewline
Write-Output "Active plan set to: $PlanId"
Write-Output "Path: $PlanDir"
Write-Output ""
Write-Output "To pin this terminal session only:"
Write-Output "`$env:PLAN_ID = '$PlanId'"
@@ -0,0 +1,50 @@
#!/bin/sh
# planning-with-files: set or display the active plan pointer.
#
# Usage:
# set-active-plan.sh <plan_id> — pin .planning/.active_plan to plan_id
# set-active-plan.sh — print the current active plan (if any)
#
# The active plan is stored in .planning/.active_plan and is read by
# resolve-plan-dir.sh when no $PLAN_ID env var is set.
set -e
PLAN_ROOT="${PWD}/.planning"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
# No args → show current active plan
if [ "${1:-}" = "" ]; then
if [ -f "${ACTIVE_FILE}" ]; then
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
if [ -n "${plan_id}" ] && [ -d "${PLAN_ROOT}/${plan_id}" ]; then
echo "Active plan: ${plan_id}"
echo "Path: ${PLAN_ROOT}/${plan_id}"
elif [ -n "${plan_id}" ]; then
echo "Active plan pointer: ${plan_id} (directory not found — stale pointer)"
else
echo "No active plan set."
fi
else
echo "No active plan set."
fi
exit 0
fi
PLAN_ID="$1"
PLAN_DIR="${PLAN_ROOT}/${PLAN_ID}"
if [ ! -d "${PLAN_DIR}" ]; then
echo "Error: plan directory not found: ${PLAN_DIR}" >&2
echo "Run: init-session.sh \"${PLAN_ID}\" to create it, or check .planning/ for available plans." >&2
exit 1
fi
mkdir -p "${PLAN_ROOT}"
printf "%s\n" "${PLAN_ID}" > "${ACTIVE_FILE}"
echo "Active plan set to: ${PLAN_ID}"
echo "Path: ${PLAN_DIR}"
echo ""
echo "To pin this terminal session only:"
echo " export PLAN_ID=${PLAN_ID}"
+16
View File
@@ -2,6 +2,22 @@
All notable changes to this project will be documented in this file.
## [2.36.3] - 2026-05-01
### Fixed
- **Missing parallel planning scripts in canonical skill copy**: `resolve-plan-dir.sh`, `resolve-plan-dir.ps1`, `set-active-plan.sh`, and `set-active-plan.ps1` were added to `scripts/` in v2.36.0 but never propagated to `skills/planning-with-files/scripts/` or the IDE mirror folders. Users installing via `npx skills add` could not use the v2.36.0 parallel planning workflow because the key scripts were not shipped in the install. Same class of gap as PR #149.
- **`sync-ide-folders.py` manifest incomplete**: the sync manifest only listed the original five scripts and did not include the four new v2.36.0 scripts. Running the sync tool after this release propagates all nine user-facing scripts to all IDE mirrors.
- **`test_canonical_script_sync.py` did not cover new scripts**: the SHARED_SCRIPTS tuple in the regression test from PR #149 only listed the original four scripts. Updated to include all eight user-facing scripts that must stay in sync between `scripts/` and `skills/planning-with-files/scripts/`.
### Added
- **Parallel planning documentation in SKILL.md**: the Scripts section now documents `resolve-plan-dir.sh` and `set-active-plan.sh` with usage descriptions and a parallel task workflow example showing how to use slug mode, `set-active-plan.sh`, and `export PLAN_ID` together.
### Changed
- Version bumped to 2.36.3 across 14 SKILL.md variants, `plugin.json`, `marketplace.json`, and `CITATION.cff`
## [2.36.2] - 2026-05-01
### Fixed
+1 -1
View File
@@ -7,7 +7,7 @@ authors:
- family-names: Adi
given-names: Ahmad Othman Ammar
alias: OthmanAdi
version: "2.36.2"
version: "2.36.3"
date-released: "2026-05-01"
license: MIT
url: "https://github.com/OthmanAdi/planning-with-files"
+2 -1
View File
@@ -13,7 +13,7 @@
[![Skills Playground](https://skillsplayground.com/badges/installs/othmanadi-planning-with-files-planning-with-files.svg)](https://skillsplayground.com/skills/othmanadi-planning-with-files-planning-with-files/)
[![Downloads](https://skill-history.com/badge/othmanadi/planning-with-files.svg)](https://skill-history.com/othmanadi/planning-with-files)
[![Version](https://img.shields.io/badge/version-2.36.2-brightgreen)](https://github.com/OthmanAdi/planning-with-files/releases)
[![Version](https://img.shields.io/badge/version-2.36.3-brightgreen)](https://github.com/OthmanAdi/planning-with-files/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Closed Issues](https://img.shields.io/github/issues-closed/OthmanAdi/planning-with-files?color=success)](https://github.com/OthmanAdi/planning-with-files/issues?q=is%3Aissue+is%3Aclosed)
[![Closed PRs](https://img.shields.io/github/issues-pr-closed/OthmanAdi/planning-with-files?color=success)](https://github.com/OthmanAdi/planning-with-files/pulls?q=is%3Apr+is%3Aclosed)
@@ -67,6 +67,7 @@ See the full list of everyone who made this project better in [CONTRIBUTORS.md](
| Version | Highlights |
|---------|------------|
| **v2.36.3** | **Parallel planning scripts now ship in the skill**: `resolve-plan-dir.sh` and `set-active-plan.sh` were missing from the installed skill in v2.36.0; now in canonical + all IDE mirrors + SKILL.md docs updated |
| **v2.36.2** | **Canonical script sync** (PR #149): `skills/planning-with-files/scripts/init-session.sh` was missing slug mode from v2.36.0; now synced with IDE mirrors + regression test. (thanks @voidborne-d!) |
| **v2.36.1** | **Security hardening**: Stop hook cache search removed, ExecutionPolicy Bypass changed to RemoteSigned, prompt injection delimiters added. (Gen Agent Trust Hub FAIL resolved) |
| **v2.36.0** | **Parallel plan isolation + Codex session isolation** (closes #146, #148): `init-session.sh` slug mode, `set-active-plan.sh`, `resolve-plan-dir.sh`, all Codex hooks route through resolver, session attachment gating. **Hermes docs** (closes #147): integration notes added to `docs/hermes.md`. 34 new tests. (thanks @githubYiheng, @09ashishkapoor, @shawnli1874!) |
+4
View File
@@ -46,6 +46,10 @@ SCRIPTS = [
"scripts/init-session.sh",
"scripts/init-session.ps1",
"scripts/session-catchup.py",
"scripts/resolve-plan-dir.sh",
"scripts/resolve-plan-dir.ps1",
"scripts/set-active-plan.sh",
"scripts/set-active-plan.ps1",
]
# ─── IDE sync manifests ───────────────────────────────────────────
+1 -1
View File
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -Command \"& (Get-ChildItem -Path (Join-Path ~ '.claude/plugins/cache') -Filter check-complete.ps1 -Recurse -EA 0 | Select-Object -First 1).FullName\" 2>/dev/null || sh \"$(ls $HOME/.claude/plugins/cache/*/*/*/scripts/check-complete.sh 2>/dev/null | head -1)\" 2>/dev/null || true"
metadata:
version: "2.36.2"
version: "2.36.3"
---
# نظام تخطيط الملفات
+1 -1
View File
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -Command \"& (Get-ChildItem -Path (Join-Path ~ '.claude/plugins/cache') -Filter check-complete.ps1 -Recurse -EA 0 | Select-Object -First 1).FullName\" 2>/dev/null || sh \"$(ls $HOME/.claude/plugins/cache/*/*/*/scripts/check-complete.sh 2>/dev/null | head -1)\" 2>/dev/null || true"
metadata:
version: "2.36.2"
version: "2.36.3"
---
# Dateiplanungssystem
+1 -1
View File
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -Command \"& (Get-ChildItem -Path (Join-Path ~ '.claude/plugins/cache') -Filter check-complete.ps1 -Recurse -EA 0 | Select-Object -First 1).FullName\" 2>/dev/null || sh \"$(ls $HOME/.claude/plugins/cache/*/*/*/scripts/check-complete.sh 2>/dev/null | head -1)\" 2>/dev/null || true"
metadata:
version: "2.36.2"
version: "2.36.3"
---
# Sistema de Planificación con Archivos
+1 -1
View File
@@ -24,7 +24,7 @@ hooks:
command: "powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -Command \"& (Get-ChildItem -Path (Join-Path ~ '.claude/plugins/cache') -Filter check-complete.ps1 -Recurse -EA 0 | Select-Object -First 1).FullName\" 2>/dev/null || sh \"$(ls $HOME/.claude/plugins/cache/*/*/*/scripts/check-complete.sh 2>/dev/null | head -1)\" 2>/dev/null || true"
metadata:
version: "2.36.2"
version: "2.36.3"
---
+1 -1
View File
@@ -24,7 +24,7 @@ hooks:
command: "powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -Command \"& (Get-ChildItem -Path (Join-Path ~ '.claude/plugins/cache') -Filter check-complete.ps1 -Recurse -EA 0 | Select-Object -First 1).FullName\" 2>/dev/null || sh \"$(ls $HOME/.claude/plugins/cache/*/*/*/scripts/check-complete.sh 2>/dev/null | head -1)\" 2>/dev/null || true"
metadata:
version: "2.36.2"
version: "2.36.3"
---
+28 -3
View File
@@ -23,7 +23,7 @@ hooks:
- type: command
command: "SKILL_PS1=\"${CLAUDE_SKILL_DIR}/scripts/check-complete.ps1\"; SKILL_SH=\"${CLAUDE_SKILL_DIR}/scripts/check-complete.sh\"; KNOWN_PS1=$(ls \"$HOME/.claude/skills/planning-with-files/scripts/check-complete.ps1\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/check-complete.ps1\" 2>/dev/null | head -1); KNOWN_SH=$(ls \"$HOME/.claude/skills/planning-with-files/scripts/check-complete.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/check-complete.sh\" 2>/dev/null | head -1); TARGET_PS1=\"${SKILL_PS1:-$KNOWN_PS1}\"; TARGET_SH=\"${SKILL_SH:-$KNOWN_SH}\"; if [ -n \"$TARGET_PS1\" ] && [ -f \"$TARGET_PS1\" ]; then powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File \"$TARGET_PS1\" 2>/dev/null; elif [ -n \"$TARGET_SH\" ] && [ -f \"$TARGET_SH\" ]; then sh \"$TARGET_SH\" 2>/dev/null; fi"
metadata:
version: "2.36.2"
version: "2.36.3"
---
# Planning with Files
@@ -208,8 +208,33 @@ Copy these templates to start:
Helper scripts for automation:
- `scripts/init-session.sh` — Initialize all planning files
- `scripts/check-complete.sh` — Verify all phases complete
- `scripts/init-session.sh` — Initialize planning files. With a name arg, creates an isolated plan under `.planning/YYYY-MM-DD-<slug>/` for parallel task workflows. Without args, writes `task_plan.md` at project root (legacy mode, backward-compatible).
- `scripts/set-active-plan.sh` — Switch the active plan pointer (`.planning/.active_plan`). Run with a plan ID to switch; run without args to show which plan is current.
- `scripts/resolve-plan-dir.sh` — Resolve the active plan directory. Checks `$PLAN_ID` env var first, then `.planning/.active_plan`, then newest plan dir by mtime, then falls back to project root (legacy). Used internally by hooks.
- `scripts/check-complete.sh` — Verify all phases in the active plan are complete.
- `scripts/session-catchup.py` — Recover context from a previous session after `/clear` (v2.2.0).
### Parallel task workflow
When working on multiple tasks in the same repo simultaneously:
```bash
# Start task A
./scripts/init-session.sh "Backend Refactor"
# → .planning/2026-01-10-backend-refactor/task_plan.md
# Start task B in a second terminal
./scripts/init-session.sh "Incident Investigation"
# → .planning/2026-01-10-incident-investigation/task_plan.md
# Switch active plan
./scripts/set-active-plan.sh 2026-01-10-backend-refactor
# Or pin a terminal to a specific plan
export PLAN_ID=2026-01-10-backend-refactor
```
Each session reads from its own isolated plan directory. Hooks resolve the correct plan automatically.
- `scripts/session-catchup.py` — Recover context from previous session (v2.2.0)
## Advanced Topics
+44
View File
@@ -0,0 +1,44 @@
# planning-with-files: resolve active plan directory (PowerShell mirror).
#
# Resolution order matches scripts/resolve-plan-dir.sh:
# 1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
# 2. .\.planning\.active_plan content
# 3. Newest .\.planning\<dir>\ by LastWriteTime
# 4. Empty (legacy fallback to .\task_plan.md handled by caller)
param(
[string]$PlanRoot = (Join-Path (Get-Location) ".planning")
)
$activeFile = Join-Path $PlanRoot ".active_plan"
if ($env:PLAN_ID) {
$candidate = Join-Path $PlanRoot $env:PLAN_ID
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
if (Test-Path $activeFile) {
$planId = (Get-Content $activeFile -Raw).Trim()
if ($planId) {
$candidate = Join-Path $PlanRoot $planId
if (Test-Path $candidate -PathType Container) {
Write-Output $candidate
exit 0
}
}
}
if (Test-Path $PlanRoot -PathType Container) {
$latest = Get-ChildItem -Path $PlanRoot -Directory |
Where-Object { -not $_.Name.StartsWith('.') } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($latest) {
Write-Output $latest.FullName
}
}
exit 0
+76
View File
@@ -0,0 +1,76 @@
#!/bin/sh
# planning-with-files: resolve active plan directory.
#
# Resolution order:
# 1. $PLAN_ID env var → ./.planning/$PLAN_ID/ if exists
# 2. ./.planning/.active_plan content → matching dir if exists
# 3. Newest ./.planning/<dir>/ by mtime
# 4. Otherwise empty stdout (caller falls back to legacy ./task_plan.md)
#
# Always exits 0. Never errors out the agent loop.
#
# Usage:
# PLAN_DIR="$(sh scripts/resolve-plan-dir.sh)"
# PLAN_FILE="${PLAN_DIR:+$PLAN_DIR/}task_plan.md"
set -u
PLAN_ROOT="${1:-${PWD}/.planning}"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
resolve_from_env() {
plan_id="${PLAN_ID:-}"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_from_active_file() {
[ -f "${ACTIVE_FILE}" ] || return 1
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
[ -z "${plan_id}" ] && return 1
candidate="${PLAN_ROOT}/${plan_id}"
if [ -d "${candidate}" ]; then
printf "%s\n" "${candidate}"
return 0
fi
return 1
}
resolve_latest_dir() {
[ -d "${PLAN_ROOT}" ] || return 1
# Portable newest-mtime selector. Avoid `ls -t` BSD/GNU drift.
# Only consider dirs that contain task_plan.md — skips system dirs like sessions/.
latest=""
latest_mtime=0
for entry in "${PLAN_ROOT}"/*/; do
[ -d "${entry}" ] || continue
# Strip trailing slash
clean="${entry%/}"
# Skip hidden dirs
case "$(basename "${clean}")" in
.*) continue ;;
esac
# Skip dirs that are not plan dirs
[ -f "${clean}/task_plan.md" ] || continue
mtime="$(date -r "${clean}" +%s 2>/dev/null || stat -c '%Y' "${clean}" 2>/dev/null || echo 0)"
if [ "${mtime}" -gt "${latest_mtime}" ] 2>/dev/null; then
latest_mtime="${mtime}"
latest="${clean}"
fi
done
if [ -n "${latest}" ]; then
printf "%s\n" "${latest}"
return 0
fi
return 1
}
if resolve_from_env; then exit 0; fi
if resolve_from_active_file; then exit 0; fi
if resolve_latest_dir; then exit 0; fi
exit 0
+50
View File
@@ -0,0 +1,50 @@
# planning-with-files: set or display the active plan pointer (PowerShell).
#
# Usage:
# .\set-active-plan.ps1 <plan_id> — pin .planning\.active_plan to plan_id
# .\set-active-plan.ps1 — print the current active plan (if any)
param(
[string]$PlanId = ""
)
$PlanRoot = Join-Path (Get-Location) ".planning"
$ActiveFile = Join-Path $PlanRoot ".active_plan"
if ($PlanId -eq "") {
if (Test-Path $ActiveFile) {
$current = (Get-Content $ActiveFile -Raw -Encoding UTF8).Trim()
$planDir = Join-Path $PlanRoot $current
if ($current -ne "" -and (Test-Path $planDir)) {
Write-Output "Active plan: $current"
Write-Output "Path: $planDir"
} elseif ($current -ne "") {
Write-Output "Active plan pointer: $current (directory not found — stale pointer)"
} else {
Write-Output "No active plan set."
}
} else {
Write-Output "No active plan set."
}
exit 0
}
$PlanDir = Join-Path $PlanRoot $PlanId
if (-not (Test-Path $PlanDir)) {
Write-Error "Error: plan directory not found: $PlanDir"
Write-Error "Run: init-session.sh `"$PlanId`" to create it, or check .planning\ for available plans."
exit 1
}
if (-not (Test-Path $PlanRoot)) {
New-Item -ItemType Directory -Path $PlanRoot -Force | Out-Null
}
Set-Content -Path $ActiveFile -Value $PlanId -Encoding UTF8 -NoNewline
Write-Output "Active plan set to: $PlanId"
Write-Output "Path: $PlanDir"
Write-Output ""
Write-Output "To pin this terminal session only:"
Write-Output "`$env:PLAN_ID = '$PlanId'"
+50
View File
@@ -0,0 +1,50 @@
#!/bin/sh
# planning-with-files: set or display the active plan pointer.
#
# Usage:
# set-active-plan.sh <plan_id> — pin .planning/.active_plan to plan_id
# set-active-plan.sh — print the current active plan (if any)
#
# The active plan is stored in .planning/.active_plan and is read by
# resolve-plan-dir.sh when no $PLAN_ID env var is set.
set -e
PLAN_ROOT="${PWD}/.planning"
ACTIVE_FILE="${PLAN_ROOT}/.active_plan"
# No args → show current active plan
if [ "${1:-}" = "" ]; then
if [ -f "${ACTIVE_FILE}" ]; then
plan_id="$(tr -d '\r\n' < "${ACTIVE_FILE}")"
if [ -n "${plan_id}" ] && [ -d "${PLAN_ROOT}/${plan_id}" ]; then
echo "Active plan: ${plan_id}"
echo "Path: ${PLAN_ROOT}/${plan_id}"
elif [ -n "${plan_id}" ]; then
echo "Active plan pointer: ${plan_id} (directory not found — stale pointer)"
else
echo "No active plan set."
fi
else
echo "No active plan set."
fi
exit 0
fi
PLAN_ID="$1"
PLAN_DIR="${PLAN_ROOT}/${PLAN_ID}"
if [ ! -d "${PLAN_DIR}" ]; then
echo "Error: plan directory not found: ${PLAN_DIR}" >&2
echo "Run: init-session.sh \"${PLAN_ID}\" to create it, or check .planning/ for available plans." >&2
exit 1
fi
mkdir -p "${PLAN_ROOT}"
printf "%s\n" "${PLAN_ID}" > "${ACTIVE_FILE}"
echo "Active plan set to: ${PLAN_ID}"
echo "Path: ${PLAN_DIR}"
echo ""
echo "To pin this terminal session only:"
echo " export PLAN_ID=${PLAN_ID}"
+59 -2
View File
@@ -29,16 +29,73 @@ TOP_SCRIPTS = REPO_ROOT / "scripts"
SKILL_SCRIPTS = REPO_ROOT / "skills" / "planning-with-files" / "scripts"
# Files that exist in both locations and must stay byte-identical.
# session-catchup.py is intentionally NOT in this list — the canonical copy carries
# Codex-specific catchup logic that does not (yet) live at the top level.
# Excluded intentionally:
# session-catchup.py — canonical carries Codex-specific logic not in top-level
# check-continue.sh — repo CI/validation script, not a user-facing skill script
# sync-ide-folders.py — repo maintenance tool, not a user-facing skill script
SHARED_SCRIPTS = (
"init-session.sh",
"init-session.ps1",
"check-complete.sh",
"check-complete.ps1",
"resolve-plan-dir.sh",
"resolve-plan-dir.ps1",
"set-active-plan.sh",
"set-active-plan.ps1",
)
class CanonicalScriptSyncTests(unittest.TestCase):
def test_shared_scripts_match_canonical_copy(self) -> None:
mismatches = []
missing_canonical = []
for name in SHARED_SCRIPTS:
top = TOP_SCRIPTS / name
skill = SKILL_SCRIPTS / name
self.assertTrue(top.is_file(), f"missing top-level script: {top}")
if not skill.is_file():
missing_canonical.append(name)
continue
if not filecmp.cmp(top, skill, shallow=False):
mismatches.append(name)
self.assertFalse(
missing_canonical,
"Script(s) exist in scripts/ but not in skills/planning-with-files/scripts/. "
f"Missing: {missing_canonical}. "
"Add the missing files to the canonical skill location and re-run "
"`python scripts/sync-ide-folders.py`.",
)
self.assertFalse(
mismatches,
"Drift detected between scripts/ and skills/planning-with-files/scripts/. "
f"Out-of-sync files: {mismatches}. "
"Update both copies in the same commit, then run "
"`python scripts/sync-ide-folders.py` to refresh IDE folders.",
)
def test_sync_ide_folders_verify_clean(self) -> None:
result = subprocess.run(
[sys.executable, str(REPO_ROOT / "scripts" / "sync-ide-folders.py"), "--verify"],
cwd=str(REPO_ROOT),
text=True,
capture_output=True,
check=False,
)
self.assertEqual(
0,
result.returncode,
"sync-ide-folders.py --verify reported drift. "
"Run `python scripts/sync-ide-folders.py` from the repo root to fix.\n"
f"stdout:\n{result.stdout}\nstderr:\n{result.stderr}",
)
if __name__ == "__main__":
unittest.main()
class CanonicalScriptSyncTests(unittest.TestCase):
def test_shared_scripts_match_canonical_copy(self) -> None:
mismatches = []