claude-dev-env 8.30.0 → 8.30.1

package/.agents/skills/windows-scheduled-task/SKILL.md

@@ -39,6 +39,7 @@ prove the task by the artifact it changes.
 - `LastTaskResult: 0` from a run that took the idle branch says nothing about the branch that acts.
 - A `#Requires -RunAsAdministrator` line pasted at a prompt checks nothing. It applies only to a script file.
 - An elevated window opens in `C:\WINDOWS\system32`. A prompt in the user's home folder is usually unelevated.
+- An Interactive task that starts `pwsh.exe -WindowStyle Hidden` still flashes a console window on the signed-in desktop. Windows draws the console before PowerShell reads the flag. `conhost.exe --headless` in front of the executable starts it with no window.
 
 ## When this applies
 
@@ -49,7 +50,7 @@ module. Register the task in an elevated shell when the task must run while the
 
 1. Resolve every executable in the action with `Get-Command <name>` and read `.Source`.
 2. Read `files[]` in `~/.claude/.claude-dev-env-manifest.json` and pick a directory that list omits.
-3. Build the action with the absolute executable path and `-WindowStyle Hidden` inside the argument string.
+3. Build the action with `conhost.exe --headless` as the executable, followed by the absolute path of the program it starts.
 4. Build a `-Once` trigger with a repetition interval and no duration, then clear the duration on the trigger object.
 5. Build the settings set.
 6. Register with an S4U principal, catch the registration failure, and register with an Interactive principal.
@@ -83,18 +84,21 @@ try {
 ```
 
 S4U runs the task with no window whether or not the user is signed in, and its registration needs an
-elevated shell. The Interactive principal with `-WindowStyle Hidden` in the action runs windowless
-while the user is signed in. Report `$PrincipalKind` so the operator knows which one the task holds.
+elevated shell. The Interactive principal runs the task on the signed-in desktop, so its action goes
+through `conhost.exe --headless` to stay windowless. Report `$PrincipalKind` so the operator knows
+which one the task holds.
 
 ## Absolute paths in the action
 
 ```powershell
+$ConhostPath = Join-Path -Path $env:SystemRoot -ChildPath 'System32\conhost.exe'
 $PwshPath = (Get-Command pwsh).Source
-$Action = New-ScheduledTaskAction -Execute $PwshPath -Argument "-NoProfile -WindowStyle Hidden -File ""$ScriptPath"""
+$Action = New-ScheduledTaskAction -Execute $ConhostPath -Argument "--headless ""$PwshPath"" -NoProfile -File ""$ScriptPath"""
 ```
 
 Resolve each executable at registration time and store the absolute path in the action. Give the
-script an absolute path too.
+script an absolute path too. The same `--headless` front works for any console program, such as
+`python.exe` or `cmd.exe`.
 
 ## Settings
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "8.30.0",
+    "version": "8.30.1",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {

package/scripts/Install-SweepEmptyDirs.ps1

@@ -99,7 +99,8 @@ if (-not $?) {
 $Target = (Resolve-Path $Target).Path
 $Target = [System.IO.Path]::TrimEndingDirectorySeparator($Target)
 
-$Action = New-ScheduledTaskAction -Execute $PythonPath -Argument """$ScriptPath"" --once --age $AgeSeconds ""$Target"""
+$ConhostPath = Join-Path -Path $env:SystemRoot -ChildPath 'System32\conhost.exe'
+$Action = New-ScheduledTaskAction -Execute $ConhostPath -Argument "--headless ""$PythonPath"" ""$ScriptPath"" --once --age $AgeSeconds ""$Target"""
 $Trigger = New-ScheduledTaskTrigger -Once -At $StartAt -RepetitionInterval (New-TimeSpan -Minutes $IntervalMinutes) -RepetitionDuration (New-TimeSpan -Days 31)
 $Settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable
 

package/scripts/tests/test_install_sweep_empty_dirs.py

@@ -0,0 +1,42 @@
+"""Specifications for the scheduled task Install-SweepEmptyDirs.ps1 registers.
+
+A task that starts a console program straight from Task Scheduler draws a
+console window on the signed-in desktop at every run. The registered action
+starts the program through conhost.exe --headless so no window appears.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+_INSTALLER_PATH = Path(__file__).resolve().parents[1] / "Install-SweepEmptyDirs.ps1"
+_UTF8_ENCODING = "utf-8"
+_ACTION_PATTERN = re.compile(
+    r"^\$Action = New-ScheduledTaskAction -Execute (\$\w+) -Argument (.+)$",
+    re.MULTILINE,
+)
+_CONHOST_ASSIGNMENT = (
+    "$ConhostPath = Join-Path -Path $env:SystemRoot -ChildPath 'System32\\conhost.exe'"
+)
+
+
+def _registered_action() -> tuple[str, str]:
+    installer_text = _INSTALLER_PATH.read_text(encoding=_UTF8_ENCODING)
+    all_actions = _ACTION_PATTERN.findall(installer_text)
+    assert len(all_actions) == 1, all_actions
+    return all_actions[0]
+
+
+def test_should_start_the_task_through_conhost() -> None:
+    installer_text = _INSTALLER_PATH.read_text(encoding=_UTF8_ENCODING)
+    executable_variable, _ = _registered_action()
+
+    assert executable_variable == "$ConhostPath"
+    assert _CONHOST_ASSIGNMENT in installer_text
+
+
+def test_should_pass_headless_before_the_python_program() -> None:
+    _, argument_text = _registered_action()
+
+    assert argument_text.startswith('"--headless ""$PythonPath"" ""$ScriptPath""')