runlist 0.95.0 → 0.95.1

package/README.md

@@ -1115,6 +1115,11 @@ validation, customize rendering and summaries, or react to lifecycle events.
 Hooks receive the resolved config and command context; mutation hooks participate
 in the command's dry-run and failure contracts.
 
+## Development checks
+
+See [VERIFYING.md](VERIFYING.md) for local checks, qualified Git toolchains,
+and the explicit compatibility and desktop qualification workflows.
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runlist",
-  "version": "0.95.0",
+  "version": "0.95.1",
   "description": "CLI for managing markdown documents with YAML frontmatter — index, query, validate, graph, export, lifecycle, and AI summaries.",
   "type": "module",
   "license": "MIT",

package/plugins/runlist-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "runlist-codex",
-  "version": "0.95.0",
+  "version": "0.95.1",
   "description": "Runlist workflow skill, session orientation, and tool guard for Codex",
   "author": {
     "name": "Reo Owens"

package/src/app-git-commits.mjs

@@ -7,6 +7,7 @@ import {gitEnvironment} from './app-git.mjs';
 import {commitStore,uuid,fail,hash} from './git-commit-store.mjs';
 import {run} from './git-commit-protocol.mjs';
 import {currentProcessOwner,processStartIdentity,processOwnerLiveness} from './atomic-mutation.mjs';
+import {requestCommitCancellation} from './git-commit-cancellation.mjs';
 // Jobs survive renderer/helper disconnect; no operation ID is ever replayed.
 const children=new Map();
 function stopped(r){if(!r.workerOwner)return r.state==='reviewed'||r.state==='failed';if(processOwnerLiveness(r.workerOwner)!=='dead')return false;try{process.kill(-r.workerOwner.pid,0);return false;}catch(e){return e.code==='ESRCH';}}
@@ -42,7 +43,7 @@ export function createAppGitCommits({config,actor,authenticate,git}){
  function inspect(req,id){identity(req);const r=store.read(id);if(!r)return null;return publicOperation(r,live(r));}
  function start(req,{operationId}){identity(req);platform();storage();return store.exclusive(()=>{const r=store.read(operationId);if(!r)fail('git-operation-missing','Review a local commit first.');if(r.state!=='reviewed'||live(r))return publicOperation(r,live(r));if(Date.now()>r.expiresAt)fail('git-review-expired','This review expired. Review current files again.');if(blocker(operationId))fail('git-operation-active','Another retained Git operation needs inspection first.');return launch(operationId,'execute');});}
  function job(req,{operationId,...request},action){identity(req);platform();storage();return store.exclusive(()=>{const r=store.read(operationId);if(!r)fail('git-operation-missing','The retained Git operation is missing.');if(live(r))fail('git-operation-running','The Git process group is still active or cannot be verified as stopped.');if(r.action==='preview')return publicOperation(r,false);if(action==='settle'){if(typeof request.note!=='string'||!request.note.trim()||request.note.length>4000||!/^[a-f0-9]{64}$/.test(request.expectedIndexRevision??'')||request.expectedRef!==r.observedRef||request.expectedIndexRevision!==r.observedIndex)fail('invalid-request','Acknowledge the current inspected ref/index with a note up to 4,000 characters.');store.update(operationId,d=>{d.settlementRequest={note:request.note.trim(),expectedRef:request.expectedRef,expectedIndexRevision:request.expectedIndexRevision};});}if(r.resolved&&action==='recover')return publicOperation(r,false);return launch(operationId,action);});}
- function cancel(req,{operationId}){identity(req);platform();const r=store.read(operationId);if(!r)fail('git-operation-missing','The retained Git operation is missing.');if(live(r)){if(processOwnerLiveness(r.workerOwner)!=='live')fail('git-owner-unverified','The worker identity cannot be verified. Keep its receipt and inspect with Git.');store.update(operationId,d=>{d.cancelRequestedAt=new Date().toISOString();});try{process.kill(-r.workerOwner.pid,'SIGKILL');}catch(error){if(error.code!=='ESRCH')throw error;}}return publicOperation(store.read(operationId),live(store.read(operationId)));}
+ function cancel(req,{operationId}){identity(req);platform();const r=store.read(operationId);if(!r)fail('git-operation-missing','The retained Git operation is missing.');if(live(r))requestCommitCancellation(store,operationId);return publicOperation(store.read(operationId),live(store.read(operationId)));}
  function list(req){identity(req);const items=[];let unavailable=0;try{for(const r of store.all())if(!r.resolved&&(r.state!=='committed'||!r.indexReady))items.push({kind:'git-commit',path:r.rows[0]?.path??r.paths[0],operationId:r.id,state:r.state,at:r.at,available:true});}catch(error){if(error.code==='forbidden')throw error;unavailable++;}return {items,unavailable};}
  return {preview,start,inspect,inspectJob:(req,body)=>job(req,body,'inspect'),recover:(req,body)=>job(req,body,'recover'),cancel,settle:(req,body)=>job(req,body,'settle'),list};
 }

package/src/filing.mjs

@@ -187,8 +187,13 @@ export function assembleFilingCoverage(docs, config, preparedRows, parentTargets
     const [hub, category] = queue[i];
     for (const dependent of dependents.get(hub) ?? []) addCategory(dependent, category);
   }
-  for (const rows of homes.values()) for (const row of rows) {
-    row.categories = row.category ? [row.category] : [...(hubCategories.get(row.hub) ?? [])].sort();
+  for (const rows of homes.values()) {
+    // Metadata reads can finish in any order. Keep CLI/GUI evidence and home
+    // pagination stable by source path and physical line, retaining duplicates.
+    rows.sort((a, b) => a.hub < b.hub ? -1 : a.hub > b.hub ? 1 : a.line - b.line);
+    for (const row of rows) {
+      row.categories = row.category ? [row.category] : [...(hubCategories.get(row.hub) ?? [])].sort();
+    }
   }
 
   // Parent inheritance is explicit and cycle-safe. A child's own home takes

package/src/git-commit-cancellation.mjs

@@ -0,0 +1,12 @@
+import {processOwnerLiveness} from './atomic-mutation.mjs';
+import {fail} from './git-commit-store.mjs';
+
+// A failed signal is never evidence that a worker or its process group stopped.
+// Keep the receipt and let the caller inspect liveness again after the request.
+export function requestCommitCancellation(store,id,{ownerLiveness=processOwnerLiveness,signal=(pid,value)=>process.kill(pid,value)}={}){
+ const r=store.read(id);
+ if(ownerLiveness(r.workerOwner)!=='live')fail('git-owner-unverified','The worker identity cannot be verified. Keep its receipt and inspect with Git.');
+ store.update(id,d=>{d.cancelRequestedAt=new Date().toISOString();});
+ try{signal(-r.workerOwner.pid,'SIGKILL');}
+ catch(error){if(error.code!=='ESRCH')fail('git-cancel-failed','The Git process group could not be stopped. Keep its receipt and inspect the operation before continuing.');}
+}