yaaw-se 0.3.9 → 0.3.10

package/dist/payload/payload-files.json

@@ -28,8 +28,8 @@
     },
     {
       "path": "payload.json",
-      "sha256": "a0cc2f108e5025cb574d243489bdd7e0696c709261d8d17adbb0653f0f6ec142",
-      "bytes": 56
+      "sha256": "2211e998c23c18c69a51c5084e54be0089740ba3a5fea80da0320a9764563064",
+      "bytes": 57
     },
     {
       "path": "skills/yaaw-create-spec/SKILL.md",
@@ -53,8 +53,8 @@
     },
     {
       "path": "skills/yaaw-orchestrator/SKILL.md",
-      "sha256": "a87e912c81b5cdab3bc76aaa922f9f3092e53e689e31e1458d71dfc9f03da57e",
-      "bytes": 666
+      "sha256": "981e912d418cd833e8281034f739e206894134a496766caacb97471b9577ec1c",
+      "bytes": 864
     },
     {
       "path": "skills/yaaw-planner/SKILL.md",
@@ -486,6 +486,11 @@
       "sha256": "27e76946abf1abde306a561621f5a7833a164f3af85db83f5db22b6809450ba6",
       "bytes": 4812
     },
+    {
+      "path": "yaaw-core/system/tools/frontmatter.mjs",
+      "sha256": "2c90097563a91c52e6f9c7748dac583e67967fd4a9748e393bf61d753594277e",
+      "bytes": 5474
+    },
     {
       "path": "yaaw-core/system/tools/orchestration-engine.mjs",
       "sha256": "5058465a85ef3f59d9da1159f7dd871f73930be95e7eaeeb11a1fa6cf4edd3c9",
@@ -493,8 +498,8 @@
     },
     {
       "path": "yaaw-core/system/tools/orchestration-runtime.mjs",
-      "sha256": "25797671d0c84d2e08499854c7e6327d67e7628a786255e6c294d291c638659e",
-      "bytes": 14566
+      "sha256": "e25923b994867d5dea2c6e9a7391ecd66371a042ee95a1ccc1553f963464efc7",
+      "bytes": 13540
     },
     {
       "path": "yaaw-core/system/tools/repository-identity.mjs",

package/dist/payload/payload.json

@@ -1,4 +1,4 @@
 {
   "schema": "yaaw.payload/v1",
-  "version": "0.3.9"
+  "version": "0.3.10"
 }

package/dist/payload/skills/yaaw-orchestrator/SKILL.md

@@ -11,4 +11,4 @@ INTENT: `CONTINUE`
 Resolve the YAAW workspace root, then invoke:
 `node .yaaw-core/system/tools/orchestration-runtime.mjs --workspace <WORKSPACE_ROOT> --invoke-skill yaaw-orchestrator`
 
-Follow `orchestration.route` until `CONTINUE_UNTIL_STOP` is satisfied or a human-input, BLOCKED, or framework stop occurs. Do not execute orchestrator semantics directly from this wrapper; every semantic execution requires the exact runtime handoff.
+Follow `orchestration.route` until `CONTINUE_UNTIL_STOP` is satisfied or a human-input, BLOCKED, or framework stop occurs. A `FRAMEWORK_STOP` is terminal for the current invocation: report it once and do not re-run the unchanged runtime unless the installation version, manifest, or managed framework bytes have changed. Do not execute orchestrator semantics directly from this wrapper; every semantic execution requires the exact runtime handoff.

package/dist/payload/yaaw-core/system/tools/frontmatter.mjs

@@ -0,0 +1,173 @@
+function indentOf(line) {
+  const match = String(line).match(/^ */);
+  return match ? match[0].length : 0;
+}
+
+function unquote(raw) {
+  if (raw.length >= 2 && raw.startsWith("\"") && raw.endsWith("\"")) {
+    try { return JSON.parse(raw); } catch { return raw.slice(1, -1); }
+  }
+  if (raw.length >= 2 && raw.startsWith("'") && raw.endsWith("'")) {
+    return raw.slice(1, -1).replace(/''/g, "'");
+  }
+  return raw;
+}
+
+function splitInline(raw) {
+  const out = [];
+  let start = 0, quote = null, depth = 0;
+  for (let i = 0; i < raw.length; i += 1) {
+    const ch = raw[i];
+    if (quote) {
+      if (ch === quote && raw[i - 1] !== "\\") quote = null;
+      continue;
+    }
+    if (ch === "\"" || ch === "'") { quote = ch; continue; }
+    if (ch === "[" || ch === "{") depth += 1;
+    else if (ch === "]" || ch === "}") depth -= 1;
+    else if (ch === "," && depth === 0) {
+      out.push(raw.slice(start, i));
+      start = i + 1;
+    }
+  }
+  out.push(raw.slice(start));
+  return out;
+}
+
+export function parseScalar(value) {
+  const raw = String(value ?? "").trim();
+  if (raw === "") return "";
+  if (raw === "null" || raw === "~") return null;
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  if (/^-?\d+$/.test(raw)) return Number(raw);
+  if (raw.startsWith("[") && raw.endsWith("]")) {
+    try { return JSON.parse(raw); } catch {}
+    const body = raw.slice(1, -1).trim();
+    if (!body) return [];
+    return splitInline(body).map(item => parseScalar(item));
+  }
+  if (raw.startsWith("{") && raw.endsWith("}")) {
+    try { return JSON.parse(raw); } catch {}
+  }
+  return unquote(raw);
+}
+
+function nextContent(lines, index, end) {
+  for (let i = index; i < end; i += 1) {
+    const trimmed = lines[i].trim();
+    if (trimmed && !trimmed.startsWith("#")) return i;
+  }
+  return end;
+}
+
+function keyValue(text) {
+  const index = text.indexOf(":");
+  if (index <= 0) return null;
+  return [text.slice(0, index).trim(), text.slice(index + 1).trim()];
+}
+
+function parseMapping(lines, start, end, indent) {
+  const out = {};
+  let i = start;
+  while (i < end) {
+    i = nextContent(lines, i, end);
+    if (i >= end) break;
+    const raw = lines[i], current = indentOf(raw), trimmed = raw.trim();
+    if (current < indent) break;
+    if (current > indent) throw new Error(`unexpected indentation at frontmatter line ${i + 1}`);
+    if (trimmed.startsWith("-")) break;
+    const pair = keyValue(trimmed);
+    if (!pair) throw new Error(`invalid frontmatter mapping at line ${i + 1}`);
+    const [key, rest] = pair;
+    if (rest !== "") {
+      out[key] = parseScalar(rest);
+      i += 1;
+      continue;
+    }
+    const next = nextContent(lines, i + 1, end);
+    if (next >= end || indentOf(lines[next]) <= indent) {
+      out[key] = {};
+      i += 1;
+      continue;
+    }
+    const [child, after] = parseNode(lines, next, end, indentOf(lines[next]));
+    out[key] = child;
+    i = after;
+  }
+  return [out, i];
+}
+
+function parseSequence(lines, start, end, indent) {
+  const out = [];
+  let i = start;
+  while (i < end) {
+    i = nextContent(lines, i, end);
+    if (i >= end) break;
+    const raw = lines[i], current = indentOf(raw), trimmed = raw.trim();
+    if (current < indent) break;
+    if (current > indent) throw new Error(`unexpected indentation at frontmatter line ${i + 1}`);
+    if (!trimmed.startsWith("-")) break;
+    const body = trimmed.slice(1).trim();
+    if (body === "") {
+      const next = nextContent(lines, i + 1, end);
+      if (next >= end || indentOf(lines[next]) <= indent) {
+        out.push(null);
+        i += 1;
+        continue;
+      }
+      const [child, after] = parseNode(lines, next, end, indentOf(lines[next]));
+      out.push(child);
+      i = after;
+      continue;
+    }
+    const pair = keyValue(body);
+    if (pair) {
+      const item = {};
+      const [key, rest] = pair;
+      item[key] = rest === "" ? {} : parseScalar(rest);
+      const next = nextContent(lines, i + 1, end);
+      if (next < end && indentOf(lines[next]) > indent) {
+        const childIndent = indentOf(lines[next]);
+        if (rest === "") {
+          const [child, after] = parseNode(lines, next, end, childIndent);
+          item[key] = child;
+          i = after;
+        } else {
+          const [extra, after] = parseMapping(lines, next, end, childIndent);
+          Object.assign(item, extra);
+          i = after;
+        }
+      } else {
+        i += 1;
+      }
+      out.push(item);
+      continue;
+    }
+    out.push(parseScalar(body));
+    i += 1;
+  }
+  return [out, i];
+}
+
+function parseNode(lines, start, end, indent) {
+  const index = nextContent(lines, start, end);
+  if (index >= end) return [{}, end];
+  return lines[index].trim().startsWith("-")
+    ? parseSequence(lines, index, end, indent)
+    : parseMapping(lines, index, end, indent);
+}
+
+export function parseFrontmatter(text) {
+  const lines = String(text).split(/\r?\n/);
+  if (lines[0]?.trim() !== "---") throw new Error("missing opening frontmatter");
+  const relativeEnd = lines.slice(1).findIndex(line => line.trim() === "---");
+  if (relativeEnd < 0) throw new Error("missing closing frontmatter");
+  const end = relativeEnd + 1;
+  const start = nextContent(lines, 1, end);
+  if (start >= end) return {};
+  const [value, after] = parseMapping(lines, start, end, indentOf(lines[start]));
+  const trailing = nextContent(lines, after, end);
+  if (trailing < end) throw new Error(`unsupported frontmatter syntax at line ${trailing + 1}`);
+  return value;
+}

package/dist/payload/yaaw-core/system/tools/orchestration-runtime.mjs

@@ -3,22 +3,21 @@ import {spawnSync} from "node:child_process";
 import {mkdir,readFile,readdir,rm,writeFile} from "node:fs/promises";
 import {basename,join,resolve} from "node:path";
 import {applyReconciliation,handoffBasis,planNext} from "./orchestration-engine.mjs";
+import {parseFrontmatter} from "./frontmatter.mjs";
 
 const argv=process.argv.slice(2);let workspaceArg=".",mode="prepare",invokeSkill=null;
 for(let i=0;i<argv.length;i++){if(argv[i]==="--workspace"&&argv[i+1])workspaceArg=argv[++i];else if(argv[i]==="--inspect-only")mode="inspect";else if(argv[i]==="--check-handoff")mode="check";else if(argv[i]==="--reconcile-one")mode="reconcile";else if(argv[i]==="--invoke-skill"&&argv[i+1])invokeSkill=argv[++i];else{process.stderr.write("usage: orchestration-runtime.mjs [--workspace <path>] [--invoke-skill <id>] [--inspect-only|--check-handoff|--reconcile-one]\n");process.exit(2);}}
 const workspace=resolve(workspaceArg),systemRoot=join(workspace,".yaaw-core","system"),projectRoot=join(workspace,".yaaw-core","project"),runtimeRoot=join(workspace,".yaaw-core","runtime");
 const observedPath=join(runtimeRoot,"observed-state.json"),handoffPath=join(runtimeRoot,"handoff.json"),intentPath=join(runtimeRoot,"intent.json"),statePath=join(projectRoot,"state.json");
 const json=async p=>JSON.parse(await readFile(p,"utf8"));const maybe=async p=>{try{return await json(p)}catch{return null}};const uniq=a=>[...new Set(a.filter(Boolean))];
-function scalar(s){s=s.trim();if(s==="null")return null;if(s==="true")return true;if(s==="false")return false;if(/^-?\d+$/.test(s))return Number(s);if(s.startsWith("[")||s.startsWith("{"))try{return JSON.parse(s)}catch{}return s.replace(/^["']|["']$/g,"")}
-async function fm(path){try{const l=(await readFile(path,"utf8")).split(/\r?\n/);if(l[0]?.trim()!=="---")return null;const n=l.slice(1).findIndex(x=>x.trim()==="---");if(n<0)return null;const d={};for(const x of l.slice(1,n+1)){if(!x.trim()||/^\s/.test(x)||!x.includes(":"))continue;const i=x.indexOf(":");d[x.slice(0,i).trim()]=scalar(x.slice(i+1));}return d}catch{return null}}
-async function review(path){try{const l=(await readFile(path,"utf8")).split(/\r?\n/);const n=l.slice(1).findIndex(x=>x.trim()==="---");if(l[0]?.trim()!=="---"||n<0)return null;const d={repository:{}};let repo=false;for(const x of l.slice(1,n+1)){if(/^repository:\s*$/.test(x)){repo=true;continue}const m=x.match(/^\s{2}([A-Za-z0-9_]+):\s*(.*)$/);if(repo&&m){d.repository[m[1]]=scalar(m[2]);continue}if(!/^\S/.test(x))continue;repo=false;const t=x.match(/^([A-Za-z0-9_]+):\s*(.*)$/);if(t)d[t[1]]=scalar(t[2]);}return d}catch{return null}}
+async function fm(path){try{return parseFrontmatter(await readFile(path,"utf8"))}catch{return null}}
 async function list(dir,re){try{return(await readdir(dir,{withFileTypes:true})).filter(x=>x.isFile()&&re.test(x.name)).map(x=>join(dir,x.name)).sort()}catch{return[]}}
 function run(tool,args){const r=spawnSync(process.execPath,[tool,...args],{cwd:workspace,encoding:"utf8",windowsHide:true,maxBuffer:64*1024*1024});try{return JSON.parse(r.stdout||"{}")}catch{throw new Error((r.stderr||"").trim()||"invalid JSON from "+basename(tool))}}
 function framework(raw,status=raw?.status??"UNKNOWN"){return{yaaw_version:String(raw?.package_version??"unknown"),system_schema:Number(raw?.system_schema??1),installation_schema:Number(raw?.installation_schema??1),project_schema:Number(raw?.project_schema??1),manifest_digest:String(raw?.manifest_digest??"sha256:unknown"),integrity_status:status,modified:Array.isArray(raw?.modified)?raw.modified:[],missing:Array.isArray(raw?.missing)?raw.missing:[],local_overrides:Array.isArray(raw?.local_overrides)?raw.local_overrides:[],repair_required:status!=="HEALTHY"}}
 function repo(raw){return{schema:"yaaw.repository-identity/v2",algorithm:raw?.algorithm??null,status:raw?.status??"UNAVAILABLE",workspace_scope:String(raw?.workspace_scope??"."),git_root_relation:raw?.git_root_relation??"unknown",head_commit:raw?.head_commit??null,dirty:typeof raw?.dirty==="boolean"?raw.dirty:null,worktree_digest:raw?.worktree_digest??null,components:raw?.components??null,changed_paths:Array.isArray(raw?.changed_paths)?raw.changed_paths:[],error:raw?.error??null}}
 async function contracts(){const names=["workflows","execution-policy","role-io","routing-policy","handoff-policy","artifacts","skills","transitions","reconciliation-policy"];const vals=await Promise.all(names.map(n=>json(join(systemRoot,"registries",n+".json"))));const c=Object.fromEntries(names.map((n,i)=>[n.replaceAll("-","_"),vals[i]])),errors=[];for(const[w,p]of Object.entries(c.handoff_policy.workflows??{})){const reg=c.workflows[w],ex=c.execution_policy.workflows?.[w],io=c.role_io.roles?.[reg?.role];if(!reg)errors.push("unknown workflow "+w);if(!ex)errors.push("no execution policy "+w);if(!io)errors.push("unknown role "+reg?.role);if(io){const br=(p.reads??[]).filter(x=>!io.reads.includes(x)),bw=(p.writes??[]).filter(x=>!io.writes.includes(x));if(br.length)errors.push(w+" bad reads "+br);if(bw.length)errors.push(w+" bad writes "+bw)}}return{...c,errors}}
 const rel=p=>p.replace(workspace+"/","").replaceAll("\\","/"),specId=v=>String(v??"").match(/SPEC-[0-9]+/)?.[0]??null;
-async function inspect(state){const pp=join(projectRoot,"product.md"),ep=join(projectRoot,"engineering.md"),specs={},tickets={},reviews=[],evidence=[];for(const p of await list(join(projectRoot,"specs"),/^SPEC-[0-9]+\.md$/)){const m=await fm(p);if(m?.id)specs[m.id]={path:rel(p),meta:m}}for(const p of await list(join(projectRoot,"tickets"),/^TASK-[0-9]+\.md$/)){const m=await fm(p);if(m?.id)tickets[m.id]={path:rel(p),meta:m}}for(const p of await list(join(projectRoot,"reviews"),/^TASK-[0-9]+-R[0-9]+\.md$/)){const v=await review(p);if(v)reviews.push({path:rel(p),value:v})}for(const p of await list(join(projectRoot,"evidence"),/\.json$/)){try{evidence.push({path:rel(p),value:await json(p)})}catch{}}return{product:{path:rel(pp),meta:await fm(pp)},engineering:{path:rel(ep),meta:await fm(ep)},specs,tickets,reviews,evidence,research:(await list(join(projectRoot,"research"),/^RSH-.*\.md$/)).map(rel),rules:(await list(join(projectRoot,"rules"),/\.md$/)).map(rel),activeSpecId:specId(state?.planning?.active_spec)}}
+async function inspect(state){const pp=join(projectRoot,"product.md"),ep=join(projectRoot,"engineering.md"),specs={},tickets={},reviews=[],evidence=[];for(const p of await list(join(projectRoot,"specs"),/^SPEC-[0-9]+\.md$/)){const m=await fm(p);if(m?.id)specs[m.id]={path:rel(p),meta:m}}for(const p of await list(join(projectRoot,"tickets"),/^TASK-[0-9]+\.md$/)){const m=await fm(p);if(m?.id)tickets[m.id]={path:rel(p),meta:m}}for(const p of await list(join(projectRoot,"reviews"),/^TASK-[0-9]+-R[0-9]+\.md$/)){const v=await fm(p);if(v)reviews.push({path:rel(p),value:v})}for(const p of await list(join(projectRoot,"evidence"),/\.json$/)){try{evidence.push({path:rel(p),value:await json(p)})}catch{}}return{product:{path:rel(pp),meta:await fm(pp)},engineering:{path:rel(ep),meta:await fm(ep)},specs,tickets,reviews,evidence,research:(await list(join(projectRoot,"research"),/^RSH-.*\.md$/)).map(rel),rules:(await list(join(projectRoot,"rules"),/\.md$/)).map(rel),activeSpecId:specId(state?.planning?.active_spec)}}
 function summary(a){return{product:a.product.meta?a.product:null,engineering:a.engineering.meta?a.engineering:null,specs:a.specs,tickets:a.tickets,reviews:a.reviews.map(x=>x.path),evidence:a.evidence.map(x=>x.path)}}
 function requirement(r,repository){return r==="NONE"||r==="INSPECT"&&["READY","UNVERSIONED"].includes(repository.status)||r==="IDENTITY"&&repository.status==="READY"}
 function refs(policy,a,ticket,state){const out=[];for(const x of policy.reads??[]){if(x==="product"&&a.product.meta)out.push(a.product.path);else if(x==="engineering"&&a.engineering.meta)out.push(a.engineering.path);else if(x==="spec"){const id=specId(state?.planning?.active_spec);if(id&&a.specs[id])out.push(a.specs[id].path)}else if(x==="ticket"&&ticket&&a.tickets[ticket])out.push(a.tickets[ticket].path);else if(x==="evidence")out.push(...a.evidence.map(v=>v.path));else if(x==="review")out.push(...a.reviews.map(v=>v.path));else if(x==="engineering_research")out.push(...a.research);else if(x==="project_rule")out.push(...a.rules);else if(x==="state")out.push(".yaaw-core/project/state.json")}return uniq(out)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaaw-se",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "Artifact-first autonomous software engineering workflow installer.",
   "type": "module",
   "bin": {