portable-agent-layer 0.53.0 → 0.54.1

package/assets/templates/PAL/ALGORITHM.md

@@ -21,6 +21,7 @@ Assign ONE tier at the start of OBSERVE. Default is Standard — only escalate i
 | Plan Mode (EnterPlanMode) | Skip | Use for user alignment |
 | LEARN phase | Reflection log + threads | + Wisdom frame |
 | Constraint extraction | Inline in reverse engineering | Numbered [EX-N] list |
+| Criteria tracking | Inline checklist only | + TaskCreate one task per criterion at end of OBSERVE |
 
 ## The Five Phases
 
@@ -208,6 +209,8 @@ For EACH criterion:
 
 **Demonstrate, don't assert.** When verifying a new check / rule / behavior on a system that already passes, "existing inputs still pass" is not evidence the new logic works — the existing inputs would pass even if your code did nothing. Construct a deliberately-broken minimal example (a fake bad slide, a known-failing input, a unit test that should now fail without your change) and run it through to prove the new behavior actually fires. Show the failure happening in the verification output, not just the success case.
 
+**Evidence gate:** A criterion with no evidence line is an automatic FAIL — list it explicitly, fix it, then re-verify. Do not advance to LEARN with any criterion unevidenced. "Looks correct" or "should work" does not count as evidence.
+
 If any criteria failed, fix and re-verify before completing.
 
 ### ━━━ 📚 LEARN ━━━ 5/5
@@ -293,7 +296,7 @@ bun ~/.pal/tools/handoff-note.ts --done --title "what we completed"
 **Project work** — use ISCs, not threads:
 ```bash
 # Close completed ISCs:
-bun ~/.pal/tools/project.ts check-isc <project-name> <id>
+bun ~/.pal/tools/project.ts complete-isc <project-name> <id>
 
 # Open new ISCs for unfinished work:
 bun ~/.pal/tools/project.ts add-isc <project-name> "what remains"

package/assets/templates/settings.claude.json

@@ -43,7 +43,10 @@
       "Need something reusable? Use the /create-skill command.",
       "PAL learns from your feedback and improves over time. Don't be shy to give feedback!",
       "For simple PDFs use the /create-pdf skill. Need a styled one? Use /consulting-report instead.",
-      "Use the /research skill to run comprehensive web research with multiple parallel agents."
+      "Use the /research skill to run comprehensive web research with multiple parallel agents.",
+      "Create presentations in HTML using the /presentation skill.",
+      "PAL can \"see\" what you are doing in the browser with the /playwright skill.",
+      "Want PAL to watch a youtube video? There's /analyze-youtube for that."
     ]
   },
   "hooks": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.53.0",
+  "version": "0.54.1",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {

package/src/hooks/handlers/update-check.ts

@@ -1,8 +1,8 @@
 /**
  * Update checker — detects if a newer version of PAL is available.
  *
- * Package mode: fetch npm registry for latest version vs installed
- * Repo mode: opt in with PAL_UPDATE_MODE=repo to compare HEAD vs origin/main
+ * Repo mode: auto-detected when a .git directory exists at palPkg() root.
+ * Package mode: fallback when no .git is present (global bun install).
  *
  * Caches result in state/update-available.json. Checked at most once per hour.
  */
@@ -47,7 +47,7 @@ function writeCache(cache: UpdateCache): void {
 }
 
 function isRepoMode(): boolean {
-  return process.env.PAL_UPDATE_MODE === "repo" && existsSync(resolve(palPkg(), ".git"));
+  return existsSync(resolve(palPkg(), ".git"));
 }
 
 function getInstalledVersion(): string {

package/src/targets/lib.ts

@@ -346,13 +346,25 @@ export function mergeCursorHooks(
 
   if (template.hooks) {
     result.hooks ??= {};
+
+    // Collect canonical forms of all template hook commands
+    const palCanonical = new Set<string>();
+    for (const entries of Object.values(template.hooks)) {
+      for (const entry of entries) palCanonical.add(canonicalPalCmd(entry.command));
+    }
+
+    // Strip existing PAL hooks that match canonically (removes old-path duplicates)
+    for (const [event, entries] of Object.entries(result.hooks)) {
+      result.hooks[event] = entries.filter(
+        (e) => !palCanonical.has(canonicalPalCmd(e.command))
+      );
+      if (result.hooks[event].length === 0) delete result.hooks[event];
+    }
+
+    // Insert template entries (old-path versions were just stripped)
     for (const [event, entries] of Object.entries(template.hooks)) {
       const current = result.hooks[event] ?? [];
-      for (const entry of entries) {
-        if (!current.some((e) => e.command === entry.command)) {
-          current.push(entry);
-        }
-      }
+      for (const entry of entries) current.push(entry);
       result.hooks[event] = current;
     }
   }

package/src/tools/agent/project.ts

@@ -378,9 +378,9 @@ function cmdAddIsc(args: string[]): void {
   ok({ added: true, id, title });
 }
 
-function cmdCheckIsc(args: string[]): void {
-  const name = args[0] ?? fail("Usage: check-isc <name> <id>");
-  const id = Number(args[1] ?? fail("Usage: check-isc <name> <id>"));
+function cmdCompleteIsc(args: string[]): void {
+  const name = args[0] ?? fail("Usage: complete-isc <name> <id>");
+  const id = Number(args[1] ?? fail("Usage: complete-isc <name> <id>"));
   if (!Number.isInteger(id) || id < 1) fail("ISC id must be a positive integer");
   const p = requireProject(name);
   const current = p.criteria ?? "";
@@ -396,6 +396,24 @@ function cmdCheckIsc(args: string[]): void {
   ok({ checked: true, id });
 }
 
+function cmdReopenIsc(args: string[]): void {
+  const name = args[0] ?? fail("Usage: reopen-isc <name> <id>");
+  const id = Number(args[1] ?? fail("Usage: reopen-isc <name> <id>"));
+  if (!Number.isInteger(id) || id < 1) fail("ISC id must be a positive integer");
+  const p = requireProject(name);
+  const current = p.criteria ?? "";
+  const existing = parseIscs(current).find((i) => i.id === id);
+  if (!existing) fail(`ISC-${id} not found in project "${name}"`);
+  if (!existing.checked) {
+    ok({ checked: false, id, alreadyOpen: true });
+    return;
+  }
+  p.criteria = patchIsc(current, id, false);
+  p.updated = now();
+  writeProject(p);
+  ok({ checked: false, id });
+}
+
 function cmdListIsc(args: string[]): void {
   const name = args[0] ?? fail("Usage: list-isc <name>");
   const p = requireProject(name);
@@ -482,7 +500,8 @@ Commands:
   update-section <name> <section> "content"     set an ISA body section
   criteria <name>                               print the Criteria section
   add-isc <name> "title"                        append a new open ISC to Criteria
-  check-isc <name> <id>                         mark ISC-N as done
+  complete-isc <name> <id>                      mark ISC-N as done
+  reopen-isc <name> <id>                        reopen ISC-N (mark not done)
   list-isc <name>                               list all ISCs with open/done status
   isa-init <name>                               mark project as ISA-initialized
   scaffold-task-isa <title>                     create a one-shot task ISA in memory/work/
@@ -566,8 +585,11 @@ function run(): void {
     case "add-isc":
       cmdAddIsc(rest);
       return;
-    case "check-isc":
-      cmdCheckIsc(rest);
+    case "complete-isc":
+      cmdCompleteIsc(rest);
+      return;
+    case "reopen-isc":
+      cmdReopenIsc(rest);
       return;
     case "list-isc":
       cmdListIsc(rest);