yaml-flow 5.2.2 → 5.2.6

package/examples/example-board/demo-chat-handler.js

@@ -4,9 +4,15 @@
  * Invoked by reusable-server-runtime after a user message is persisted:
  *   node demo-chat-handler.js --boardId <id> --cardId <id> --extraEncJson <base64json>
  *
- * extraEncJson decodes to: { chatDir, boardDir, lastChatFile }
+ * extraEncJson decodes to:
+ *   boardSetupRoot  — absolute path to board root (parent of runtime/, surface/, runtime-out/)
+ *   boardRuntimeDir — relative subdir: 'runtime'
+ *   runtimeStatusDir— relative subdir: 'runtime-out'
+ *   cardsDir        — relative subdir: 'surface/tmp-cards'
+ *   chatDir         — absolute path to the card's chats directory
+ *   lastChatFile    — filename of the just-written user message, e.g. '001_user.txt'
  *
- * If the card has a source entry containing a "copilot" key, invokes copilot_wrapper.bat.
+ * Invokes copilot_wrapper.bat with a prompt built from conversation history.
  * Session dir is per-card: os.tmpdir()/demo-chat-handler-sessions/<boardId>_<cardId>
  */
 
@@ -27,19 +33,27 @@ function getArg(name) {
   return idx !== -1 && args[idx + 1] !== undefined ? args[idx + 1] : null;
 }
 
-const boardId  = getArg('--boardId') || '';
-const cardId   = getArg('--cardId') || '';
-const extraStr = getArg('--extraEncJson') || '';
+const boardId     = getArg('--boardId') || '';
+const cardId      = getArg('--cardId') || '';
+const extraStr    = getArg('--extraEncJson') || '';
+const cleanOnExit = getArg('--cleanOnExit') || '';
 
 let extra = {};
 try { extra = JSON.parse(Buffer.from(extraStr, 'base64').toString('utf-8')); }
 catch { console.error('[demo-chat-handler] bad --extraEncJson'); process.exit(0); }
 
-const { chatDir, boardDir, lastChatFile } = extra;
-  console.error('[demo-chat-handler] missing chatDir/lastChatFile');
+const { boardSetupRoot, boardRuntimeDir, runtimeStatusDir, cardsDir, chatDir, lastChatFile } = extra;
+if (!boardSetupRoot || !chatDir || !lastChatFile) {
+  console.error('[demo-chat-handler] missing boardSetupRoot/chatDir/lastChatFile');
   process.exit(0);
 }
 
+// Resolve absolute paths from the structured extra fields
+const boardRuntimeDirAbs  = path.join(boardSetupRoot, boardRuntimeDir  || 'runtime');
+const runtimeStatusDirAbs = path.join(boardSetupRoot, runtimeStatusDir || 'runtime-out');
+const cardsDirAbs         = path.join(boardSetupRoot, cardsDir         || path.join('surface', 'tmp-cards'));
+const chatDirAbs          = chatDir;
+
 // ---------------------------------------------------------------------------
 // Read conversation history
 // ---------------------------------------------------------------------------
@@ -57,29 +71,31 @@ function readHistory(dir) {
   } catch { return []; }
 }
 
-// ---------------------------------------------------------------------------
-// Check if card has a 'copilot' source entry
-// ---------------------------------------------------------------------------
-function hasCopilotSource(bDir, cId) {
-  try {
-    const boardGraph = JSON.parse(fs.readFileSync(path.join(bDir, 'board-graph.json'), 'utf-8'));
-    const nodes = boardGraph?.graph?.nodes ?? boardGraph?.nodes ?? {};
-    const card  = nodes[cId];
-    const sources = card.sources ?? card.card_data?.sources ?? [];
-    if (Array.isArray(sources)) return sources.some(s => s && typeof s === 'object' && 'copilot' in s);
-    if (typeof sources === 'object') return 'copilot' in sources;
-    return false;
-  } catch { return false; }
-}
-
 // ---------------------------------------------------------------------------
 // Build prompt
 // ---------------------------------------------------------------------------
-function buildPrompt(cId, bId, history) {
+function buildPrompt(cId, bId, history, responseFileRel) {
+  const cardSetupDirRel  = path.join(cardsDir, cId).replace(/\\/g, '/');
+  const runtimeDirRel    = boardRuntimeDir  || 'runtime';
+  const statusDirRel     = runtimeStatusDir || 'runtime-out';
+  const chatDirRel       = path.relative(boardSetupRoot, chatDir).replace(/\\/g, '/');
+  const lastQueryFileRel = path.join(chatDirRel, lastChatFile).replace(/\\/g, '/');
+
+  const contextBlock = [
+    'We are currently doing a three way orchestration.',
+    'You are the responder who has context of the cards in ' + cardSetupDirRel + ',',
+    'card runtime statuses in ' + runtimeDirRel + ',',
+    'and computed outputs in ' + statusDirRel + '.',
+    'I am just a mediator passing on the query.',
+    'The user sees the data available in cards which is rendered, and the status from ' + statusDirRel + '.',
+    'Everything else is internal detail not to be exposed to the user.',
+    'The conversation history can be found in ' + chatDirRel + ' and the last query is in ' + lastQueryFileRel + '.',
+    'Write your response to the user in ' + responseFileRel + ' (relative to your working directory).',
+    'Give me only a bare minimum log line on what you did — the response in ' + responseFileRel + ' is what the user will see.',
+  ].join(' ');
+
   return [
-    'You are a helpful assistant embedded in a live card (card: "' + cId + '", board: "' + bId + '").',
-    'Help the user understand and act on the data shown in this card.',
-    'Be concise.',
+    contextBlock,
     '',
     ...history,
     'Assistant:',
@@ -120,32 +136,23 @@ function runWrapper(prompt, sessionDir, workingDir) {
 // ---------------------------------------------------------------------------
 // Main
 // ---------------------------------------------------------------------------
-const history    = readHistory(chatDir);
-const sessionDir = path.join(os.tmpdir(), 'demo-chat-handler-sessions', boardId + '_' + cardId);
-const workingDir = boardDir || process.cwd();
-const prompt     = buildPrompt(cardId, boardId, history);
+const serialMatch    = String(lastChatFile).match(/^(\d+)/);
+const nextSerial     = serialMatch ? parseInt(serialMatch[1], 10) + 1 : 1;
+const nextName       = String(nextSerial).padStart(3, '0') + '-assistant.txt';
+const responseFileRel = path.relative(boardSetupRoot, path.join(chatDir, nextName)).replace(/\\/g, '/');
 
-let response = '';
-if (hasCopilotSource(boardDir, cardId)) {
-  try {
-    response = runWrapper(prompt, sessionDir, workingDir);
-  } catch (err) {
-    response = 'Sorry, I could not reach the LLM right now. (' + String(err?.message ?? err).slice(0, 120) + ')';
-    console.error('[demo-chat-handler] wrapper failed: ' + (err?.message ?? err));
-  }
-} else {
-  response = 'No copilot source configured for this card.';
-}
-
-// Write assistant response as next serial file
-const serialMatch = String(lastChatFile).match(/^(\d+)/);
-const nextSerial  = serialMatch ? parseInt(serialMatch[1], 10) + 1 : 1;
-const nextName    = String(nextSerial).padStart(3, '0') + '-assistant.txt';
-const nextPath    = path.join(chatDir, nextName);
+const history    = readHistory(chatDirAbs);
+const sessionDir = path.join(os.tmpdir(), 'demo-chat-handler-sessions', boardId + '_' + cardId);
+const workingDir = boardSetupRoot;
+const prompt     = buildPrompt(cardId, boardId, history, responseFileRel);
 
 try {
-  fs.writeFileSync(nextPath, response + '\n', 'utf-8');
-  console.log('[demo-chat-handler] cardId="' + cardId + '" wrote response -> ' + nextPath);
+  runWrapper(prompt, sessionDir, workingDir);
+  console.log('[demo-chat-handler] cardId="' + cardId + '" copilot invoked, response expected at ' + responseFileRel);
 } catch (err) {
-  console.error('[demo-chat-handler] write failed: ' + err.message);
+  console.error('[demo-chat-handler] wrapper failed: ' + (err?.message ?? err));
+} finally {
+  if (cleanOnExit) {
+    try { fs.unlinkSync(cleanOnExit); } catch {}
+  }
 }

package/examples/example-board/demo-server.js

@@ -3,6 +3,7 @@
 import http from 'node:http';
 import fs from 'node:fs';
 import path from 'node:path';
+import os from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { createRequire } from 'node:module';
 
@@ -90,6 +91,11 @@ function resetRuntime() {
     fs.rmSync(setupDir, { recursive: true, force: true });
     console.log(`[demo-server] reset: wiped ${setupDir}`);
   }
+  const chatSessions = path.join(os.tmpdir(), 'demo-chat-handler-sessions');
+  if (fs.existsSync(chatSessions)) {
+    fs.rmSync(chatSessions, { recursive: true, force: true });
+    console.log(`[demo-server] reset: wiped ${chatSessions}`);
+  }
 }
 
 if (RESET_ON_START) {

package/examples/example-board/demo-shell-browser.html

@@ -6,9 +6,9 @@
   <title>Example Board Demo (Browser Runtime)</title>
   <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
   <script src="https://cdn.jsdelivr.net/npm/jsonata/jsonata.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/card-compute.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/board-livegraph-engine.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.6/browser/card-compute.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.6/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.6/browser/board-livegraph-engine.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/examples/example-board/demo-shell-with-server.html

@@ -16,10 +16,10 @@
   </style>
   <script src="https://cdn.jsdelivr.net/npm/jsonata/jsonata.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/card-compute.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/board-livegraph-engine.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/board-livecards-runtime-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.6/browser/card-compute.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.6/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.6/browser/board-livegraph-engine.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.6/browser/board-livecards-runtime-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/examples/example-board/scripts/copilot_wrapper.bat

@@ -0,0 +1,141 @@
+@echo off
+setlocal enabledelayedexpansion
+
+REM Copilot Wrapper - Manages session isolation for GitHub Copilot CLI
+REM Usage: copilot_wrapper.bat <output_file> <session_dir> <working_dir> <request_or_file> <result_type> [agent_name] [model] [result_shape_file]
+REM
+REM If request_or_file starts with @, it's treated as a file path containing the prompt.
+REM Otherwise, it's treated as the prompt string directly.
+REM result_type: "raw" to return plain text, "json" to extract JSON (passed to clean_copilot_output.ps1)
+REM agent_name: name of the agent for log files (optional)
+REM model: passed to copilot with --model flag (optional)
+
+SET "OUTPUT_FILE=%~1"
+SET "SESSION_DIR=%~2"
+SET "WORKING_DIR=%~3"
+SET "REQUEST_OR_FILE=%~4"
+SET "RESULT_TYPE=%~5"
+SET "AGENT_NAME=%~6"
+SET "MODEL=%~7"
+SET "RESULT_SHAPE_FILE=%~8"
+
+if not defined RESULT_TYPE SET "RESULT_TYPE=raw"
+
+SET "PROMPT_FILE="
+SET "REQUEST="
+echo !REQUEST_OR_FILE! | findstr /b "@" >nul
+if !errorlevel! equ 0 (
+    SET "PROMPT_FILE=!REQUEST_OR_FILE:~1!"
+) else (
+    SET "REQUEST=!REQUEST_OR_FILE!"
+)
+
+SET "_WD_HASH=!WORKING_DIR:\=!"
+SET "_WD_HASH=!_WD_HASH:/=!"
+SET "_WD_HASH=!_WD_HASH::=!"
+SET "_WD_HASH=!_WD_HASH:.=!"
+SET "_WD_HASH=!_WD_HASH: =!"
+SET "COPILOT_BASE=%TEMP%\copilot-sessions\!_WD_HASH!"
+SET "COPILOT_CACHE=%COPILOT_BASE%\session-state"
+SET "LOCK_FILE=%COPILOT_BASE%\copilot.lock"
+SET "UUID_FILE=%SESSION_DIR%\session.uuid"
+
+if not exist "%COPILOT_BASE%" mkdir "%COPILOT_BASE%"
+if not exist "%COPILOT_CACHE%" mkdir "%COPILOT_CACHE%"
+if not exist "%SESSION_DIR%" mkdir "%SESSION_DIR%"
+
+if exist "%LOCK_FILE%" (
+    for /f "tokens=*" %%a in ('powershell -NoProfile -Command "if ((Get-Item '%LOCK_FILE%').LastWriteTime -lt (Get-Date).AddMinutes(-20)) { Write-Output 'STALE' }"') do (
+        if "%%a"=="STALE" (
+            del "%LOCK_FILE%" 2>nul
+        )
+    )
+)
+:acquire_lock
+2>nul (
+    >"%LOCK_FILE%" (
+        echo %DATE% %TIME%
+    )
+) || (
+    timeout /t 1 /nobreak >nul
+    goto acquire_lock
+)
+
+SET "SESSION_UUID="
+if exist "%UUID_FILE%" (
+    set /p SESSION_UUID=<"%UUID_FILE%"
+) else (
+    for /f "tokens=*" %%a in ('powershell -NoProfile -Command "[guid]::NewGuid().ToString()"') do (
+        SET "SESSION_UUID=%%a"
+    )
+    echo !SESSION_UUID!>"%UUID_FILE%"
+)
+
+SET "CACHE_SESSION_PATH=%COPILOT_CACHE%\!SESSION_UUID!"
+
+if exist "%SESSION_DIR%\workspace.yaml" (
+    if exist "!CACHE_SESSION_PATH!" rmdir /s /q "!CACHE_SESSION_PATH!" 2>nul
+    mkdir "!CACHE_SESSION_PATH!" 2>nul
+    for %%f in ("%SESSION_DIR%\*") do (
+        if /i not "%%~nxf"=="session.uuid" (
+            move /y "%%f" "!CACHE_SESSION_PATH!\" >nul 2>&1
+        )
+    )
+    for /d %%d in ("%SESSION_DIR%\*") do (
+        robocopy "%%d" "!CACHE_SESSION_PATH!\%%~nxd" /E /MOVE /NFL /NDL /NJH /NJS >nul 2>&1
+    )
+)
+
+cd /d "%WORKING_DIR%"
+
+SET "MODEL_FLAG="
+if defined MODEL (
+    SET "MODEL_FLAG=--model !MODEL!"
+)
+
+if defined PROMPT_FILE (
+    type "!PROMPT_FILE!" | call copilot --allow-all --resume !SESSION_UUID! !MODEL_FLAG! > "%OUTPUT_FILE%" 2>&1
+) else (
+    call copilot -p "%REQUEST%" --allow-all --resume !SESSION_UUID! !MODEL_FLAG! > "%OUTPUT_FILE%" 2>&1
+)
+
+SET "LOG_DIR=%COPILOT_BASE%\copilot-logs"
+if not exist "!LOG_DIR!" mkdir "!LOG_DIR!"
+SET "LOG_AGENT=unknown"
+if defined AGENT_NAME SET "LOG_AGENT=!AGENT_NAME!"
+for /f "tokens=*" %%t in ('powershell -NoProfile -Command "Get-Date -Format 'yyyyMMdd-HHmmss'"') do SET "LOG_TS=%%t"
+SET "LOG_FILE=!LOG_DIR!\!LOG_AGENT!_!LOG_TS!.log"
+echo === PROMPT (!LOG_TS!) === > "!LOG_FILE!"
+echo Agent: !LOG_AGENT! >> "!LOG_FILE!"
+echo ResultType: !RESULT_TYPE! >> "!LOG_FILE!"
+echo Working Dir: %WORKING_DIR% >> "!LOG_FILE!"
+echo --- >> "!LOG_FILE!"
+if defined PROMPT_FILE (
+    type "!PROMPT_FILE!" >> "!LOG_FILE!" 2>nul
+) else (
+    echo %REQUEST% >> "!LOG_FILE!"
+)
+echo. >> "!LOG_FILE!"
+echo === RESPONSE === >> "!LOG_FILE!"
+type "%OUTPUT_FILE%" >> "!LOG_FILE!" 2>nul
+echo. >> "!LOG_FILE!"
+echo === END === >> "!LOG_FILE!"
+for /f "skip=50 tokens=*" %%f in ('dir /b /o-d "!LOG_DIR!\!LOG_AGENT!_*.log" 2^>nul') do (
+    del "!LOG_DIR!\%%f" 2>nul
+)
+
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0copilot_wrapper_helper.ps1" "%OUTPUT_FILE%" "!RESULT_TYPE!" "!RESULT_SHAPE_FILE!"
+
+if exist "!CACHE_SESSION_PATH!" (
+    for %%f in ("!CACHE_SESSION_PATH!\*") do (
+        move /y "%%f" "%SESSION_DIR%\" >nul 2>&1
+    )
+    for /d %%d in ("!CACHE_SESSION_PATH!\*") do (
+        robocopy "%%d" "%SESSION_DIR%\%%~nxd" /E /MOVE /NFL /NDL /NJH /NJS >nul 2>&1
+    )
+    rmdir "!CACHE_SESSION_PATH!" 2>nul
+)
+
+del "%LOCK_FILE%" 2>nul
+
+endlocal

package/examples/example-board/scripts/copilot_wrapper_helper.ps1

@@ -0,0 +1,181 @@
+# clean_copilot_output.ps1
+# Cleans copilot CLI output: filters noise lines and stats footer.
+# Called by copilot_wrapper.bat after copilot runs and after logging (raw log preserved).
+#
+# Usage: clean_copilot_output.ps1 <output_file> <result_type> [result_shape_file]
+#   output_file       - file containing raw copilot output; overwritten with cleaned result
+#   result_type=raw   - strip noise + stats, write plain text back to output_file
+#   result_type=json  - extract first JSON object whose keys match result_shape;
+#                       if result_shape_file is absent, accepts any valid JSON object
+#   result_shape_file - (json result_type only) JSON file whose top-level keys are required in output
+#
+# raw  result_type: right for chat responses and task executor sources.
+# json result_type: right for structured calls where the input contained {prompt, result_shape}.
+
+param(
+    [Parameter(Mandatory)][string]$OutputFile,
+    [Parameter(Mandatory)][string]$ResultType,
+    [string]$ResultShapeFile = ''
+)
+
+if (-not (Test-Path $OutputFile)) { exit 0 }
+
+$raw = [IO.File]::ReadAllText($OutputFile, [Text.Encoding]::UTF8)
+if ([string]::IsNullOrWhiteSpace($raw)) { exit 0 }
+
+# --- Step 1: Filter noise lines ---
+$lines = $raw -split "`r?`n" | Where-Object {
+    $_ -notmatch "^error: unknown option '--no-warnings'" -and
+    $_ -notmatch "^Try 'copilot --help' for more information"
+}
+$cleaned = ($lines -join "`n").Trim()
+
+# --- Step 1b: Strip copilot-cli tool operation lines ---
+# These are internal tool invocations that leak into output:
+#   ● Create/Read/Edit/List directory/Glob/Check ...
+#   X Read ... (failed tool ops)
+#   $ Get-Content/Set-Content ... (PowerShell invocations)
+#   └ N lines/files found
+#   ├ ... (tree lines)
+#   "The agent decision has been simulated and saved to ..."
+#   session-state file paths
+$noiseLines = New-Object System.Collections.Generic.List[string]
+$contentLines2 = New-Object System.Collections.Generic.List[string]
+foreach ($line in ($cleaned -split "`n")) {
+    $t = $line.TrimStart()
+    if ($t -match '^[\u25cf\u2022] ' -or           # ● bullet tool ops
+        $t -match '^X ' -or                          # X failed tool ops
+        $t -match '^\$ ' -or                         # $ shell commands
+        $t -match '^[\u2514\u251c]' -or              # └ ├ tree lines
+        $t -match 'session-state.*\.json' -or        # session-state file refs
+        $t -match 'agent.decision has been simulated' -or
+        $t -match 'has been simulated and saved' -or
+        $t -match '^\d+ (files?|lines?|matches?) found$' -or  # "3 files found"
+        $t -match '^No matches found$' -or
+        $t -match '^Path does not exist$' -or
+        $t -match '^\d+ lines?( read)?$') {          # "1 line read"
+        $noiseLines.Add($line)
+    } else {
+        $contentLines2.Add($line)
+    }
+}
+$cleaned = ($contentLines2 -join "`n").Trim()
+
+# Write noise to sidecar file for upstream visibility
+$NoiseFile = $OutputFile + '.noise'
+if ($noiseLines.Count -gt 0) {
+    $noiseContent = "STRIPPED_LINES=$($noiseLines.Count)`n" + ($noiseLines -join "`n")
+    [IO.File]::WriteAllText($NoiseFile, $noiseContent, [Text.Encoding]::UTF8)
+} elseif (Test-Path $NoiseFile) {
+    Remove-Item $NoiseFile -Force
+}
+
+# --- Step 2: Strip trailing usage stats ---
+$statsPrefixes = @('Total usage est:', 'API time spent:', 'Total session time:',
+                    'Total code changes:', 'Breakdown by AI model:', 'Session:',
+                    'Changes', 'Requests', 'Tokens')
+$resultLines = New-Object System.Collections.Generic.List[string]
+$hitStats = $false
+foreach ($line in $cleaned -split "`n") {
+    if (-not $hitStats) {
+        foreach ($sp in $statsPrefixes) {
+            if ($line.TrimStart().StartsWith($sp)) { $hitStats = $true; break }
+        }
+    }
+    if (-not $hitStats) { $resultLines.Add($line) }
+}
+$cleaned = ($resultLines -join "`n").Trim()
+
+# --- raw result_type: write cleaned plain text and exit ---
+if ($ResultType -eq 'raw') {
+    if ([string]::IsNullOrWhiteSpace($cleaned)) {
+        [IO.File]::WriteAllText($OutputFile, '', [Text.Encoding]::UTF8)
+    } else {
+        [IO.File]::WriteAllText($OutputFile, $cleaned, [Text.Encoding]::UTF8)
+    }
+    exit 0
+}
+
+# --- json result_type: extract JSON object matching result_shape ---
+
+# Load result_shape keys (if provided) to use as required-key filter
+$shapeKeys = @()
+if ($ResultShapeFile -and (Test-Path $ResultShapeFile)) {
+    try {
+        $shape = [IO.File]::ReadAllText($ResultShapeFile, [Text.Encoding]::UTF8) | ConvertFrom-Json -ErrorAction Stop
+        $shapeKeys = @($shape.PSObject.Properties.Name)
+    } catch {}
+}
+
+if ([string]::IsNullOrWhiteSpace($cleaned)) {
+    $fallback = if ($shapeKeys.Count -gt 0) {
+        $obj = [ordered]@{}
+        foreach ($k in $shapeKeys) { $obj[$k] = $null }
+        $obj | ConvertTo-Json -Depth 2 -Compress
+    } else { '{}' }
+    [IO.File]::WriteAllText($OutputFile, $fallback, [Text.Encoding]::UTF8)
+    exit 0
+}
+
+# Helper: check if a parsed object has all required shape keys
+function Test-ShapeMatch($obj) {
+    if ($shapeKeys.Count -eq 0) { return $true }  # no shape constraint — accept any JSON object
+    foreach ($k in $shapeKeys) {
+        if (-not $obj.PSObject.Properties[$k]) { return $false }
+    }
+    return $true
+}
+
+$foundJson = $null
+
+# 1: Look in ```json fenced blocks first
+if ($cleaned -match '(?s)```json\s*(.*?)```') {
+    try {
+        $obj = $Matches[1].Trim() | ConvertFrom-Json -ErrorAction Stop
+        if (Test-ShapeMatch $obj) { $foundJson = $Matches[1].Trim() }
+    } catch {}
+}
+
+# 2: Scan for bare JSON objects
+if (-not $foundJson) {
+    $depth = 0; $start = -1
+    for ($i = 0; $i -lt $cleaned.Length; $i++) {
+        if ($cleaned[$i] -eq '{') {
+            if ($depth -eq 0) { $start = $i }
+            $depth++
+        } elseif ($cleaned[$i] -eq '}') {
+            $depth--
+            if ($depth -eq 0 -and $start -ge 0) {
+                $candidate = $cleaned.Substring($start, $i - $start + 1)
+                try {
+                    $obj = $candidate | ConvertFrom-Json -ErrorAction Stop
+                    if (Test-ShapeMatch $obj) {
+                        $foundJson = $candidate
+                        break
+                    }
+                } catch {}
+                $start = -1
+            }
+        }
+    }
+}
+
+if ($foundJson) {
+    [IO.File]::WriteAllText($OutputFile, $foundJson, [Text.Encoding]::UTF8)
+} else {
+    # No matching JSON found — record raw in noise file, write shape-skeleton fallback
+    $NoiseFile = $OutputFile + '.noise'
+    $fallbackNoise = "FALLBACK=no_json_match`nSHAPE_KEYS=$($shapeKeys -join ',')`nRAW_LENGTH=$($cleaned.Length)`n---`n$cleaned"
+    if (Test-Path $NoiseFile) {
+        $existing = [IO.File]::ReadAllText($NoiseFile, [Text.Encoding]::UTF8)
+        [IO.File]::WriteAllText($NoiseFile, "$existing`n$fallbackNoise", [Text.Encoding]::UTF8)
+    } else {
+        [IO.File]::WriteAllText($NoiseFile, $fallbackNoise, [Text.Encoding]::UTF8)
+    }
+    $fallback = if ($shapeKeys.Count -gt 0) {
+        $obj = [ordered]@{}
+        foreach ($k in $shapeKeys) { $obj[$k] = $null }
+        $obj | ConvertTo-Json -Depth 2 -Compress
+    } else { '{}' }
+    [IO.File]::WriteAllText($OutputFile, $fallback, [Text.Encoding]::UTF8)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaml-flow",
-  "version": "5.2.2",
+  "version": "5.2.6",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",