@waron97/prbot 3.3.0 → 3.4.0

package/package.json

@@ -1,8 +1,12 @@
 {
     "name": "@waron97/prbot",
-    "version": "3.3.0",
+    "version": "3.4.0",
     "description": "",
     "main": "index.js",
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "packageManager": "npm@10.9.8",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1"
     },

package/src/agrippa/commands/clone.js

@@ -3,6 +3,7 @@ import select from '@inquirer/select';
 import inquirer from 'inquirer';
 import { getToken } from '../../lib/auth.js';
 import { fuzzyMatch } from '../../lib/fuzzy.js';
+import { log, warn } from '../../lib/logger.js';
 import { describeWorkflow, getPhasesByWorkflow, listMfas, listWorkflows } from '../lib/api.js';
 import { computeChecksum } from '../lib/checksum.js';
 import { loadEffectiveEnv, readConfig, writeConfig } from '../lib/config.js';
@@ -42,7 +43,7 @@ async function clone(opts) {
     if (!ripUrl)
         throw new Error('RIP_URL is not configured. Run `prbot init` or set it in agrippa.yaml.');
 
-    console.log('Fetching records...');
+    log('Fetching records...');
     const token = await getToken();
 
     let records;
@@ -53,7 +54,7 @@ async function clone(opts) {
     }
 
     if (!records.length) {
-        console.log(`No ${objectType} records found.`);
+        log(`No ${objectType} records found.`);
         return;
     }
 
@@ -92,11 +93,11 @@ async function clone(opts) {
             basePath = inputPath;
         }
 
-        console.log(`Fetching phases for "${record.name}"...`);
+        log(`Fetching phases for "${record.name}"...`);
         const phases = await getPhasesByWorkflow(token, ripUrl, record.id, { fromCode: true });
 
         if (!phases.length) {
-            console.log('No phases found.');
+            log('No phases found.');
             return;
         }
 
@@ -112,19 +113,19 @@ async function clone(opts) {
                 checksum_at_pull: computeChecksum(phase.code),
                 name: `${record.name} / ${phase.name}`,
             });
-            console.log(`  wrote ${filePath}`);
+            log(`  wrote ${filePath}`);
         }
 
         // Drop the workflow graph alongside the phase files as read-only context.
         try {
             const structure = await describeWorkflow(token, ripUrl, record.id);
             const docPath = writeWorkflowDoc(basePath, structure);
-            console.log(`  wrote ${docPath}`);
+            log(`  wrote ${docPath}`);
         } catch (err) {
-            console.warn(`  could not fetch workflow structure: ${err.message}`);
+            warn(`  could not fetch workflow structure: ${err.message}`);
         }
 
-        console.log(`Cloned ${phases.length} phase(s) to ${basePath}/`);
+        log(`Cloned ${phases.length} phase(s) to ${basePath}/`);
     } else {
         const defaultPath = defaultMfaPath(record.model_name, record.name);
         if (!basePath) {
@@ -147,7 +148,7 @@ async function clone(opts) {
             checksum_at_pull: computeChecksum(record.code),
             name: `${record.model_name} / ${record.name}`,
         });
-        console.log(`Cloned MFA to ${basePath}`);
+        log(`Cloned MFA to ${basePath}`);
     }
 
     writeConfig(config);

package/src/agrippa/commands/cloneLrp.js

@@ -1,10 +1,10 @@
 import search from '@inquirer/search';
 import inquirer from 'inquirer';
 import { getToken } from '../../lib/auth.js';
-import { computeChecksum } from '../lib/checksum.js';
+import { log, warn } from '../../lib/logger.js';
 import { loadEffectiveEnv, readConfig, writeConfig } from '../lib/config.js';
 import { getLrpXml, listLrps, resolveLrpByName } from '../lib/lrpApi.js';
-import { comparePayload, decompose, recompose, stableStringify } from '../lib/pbProject.js';
+import { checksumOfPayload, comparePayload, decompose, recompose } from '../lib/pbProject.js';
 import { projectReader, writeProject } from '../lib/pbWorkspace.js';
 
 // Clone a long-running process (LRP). Structurally identical to a PB clone
@@ -32,7 +32,7 @@ async function cloneLrp(opts) {
     if (opts.name) {
         chosen = await resolveLrpByName(token, opts.name);
     } else {
-        console.log('Fetching long-running process list...');
+        log('Fetching long-running process list...');
         const initial = await listLrps(token, null);
         let controller = null;
         chosen = await search({
@@ -65,7 +65,7 @@ async function cloneLrp(opts) {
         dest = inputPath;
     }
 
-    console.log(`Fetching "${chosen.name}"...`);
+    log(`Fetching "${chosen.name}"...`);
     const { xml, description } = await getLrpXml(token, chosen.id);
     const payload = { built_page: xml };
 
@@ -73,7 +73,7 @@ async function cloneLrp(opts) {
     writeProject(dest, files);
 
     const scriptCount = Object.keys(files).filter((p) => p.startsWith('scripts/')).length;
-    console.log(`Cloned to ${dest}/  (${scriptCount} script(s)).`);
+    log(`Cloned to ${dest}/  (${scriptCount} script(s)).`);
 
     // Prove the clone reconstructs the original XML (0-loss bar A). LRPs have
     // no `pages` at all — recompose always synthesizes `pages: []`, which
@@ -82,10 +82,10 @@ async function cloneLrp(opts) {
     const rebuilt = recompose(projectReader(dest));
     const diffs = comparePayload(payload, rebuilt).filter((d) => !d.startsWith('pages:'));
     if (diffs.length) {
-        console.warn('WARNING: round-trip verification found differences:');
-        diffs.forEach((d) => console.warn('  - ' + d));
+        warn('WARNING: round-trip verification found differences:');
+        diffs.forEach((d) => warn('  - ' + d));
     } else {
-        console.log('Round-trip verified: recomposed payload is identical (0 information loss).');
+        log('Round-trip verified: recomposed payload is identical (0 information loss).');
     }
 
     // Register in the workspace for later pull/push — keyed by NAME, not id.
@@ -102,7 +102,7 @@ async function cloneLrp(opts) {
         description,
         // Baseline for push classification (see pull.js/push.js): checksum of
         // the *recomposed* payload, changes only when local files change.
-        checksum_at_pull: computeChecksum(stableStringify(rebuilt)),
+        checksum_at_pull: checksumOfPayload(rebuilt),
         version: chosen.version,
         status: chosen.status,
     };

package/src/agrippa/commands/clonePb.js

@@ -2,10 +2,10 @@ import search from '@inquirer/search';
 import inquirer from 'inquirer';
 import { getToken } from '../../lib/auth.js';
 import { fuzzyMatch } from '../../lib/fuzzy.js';
-import { computeChecksum } from '../lib/checksum.js';
+import { log, warn } from '../../lib/logger.js';
 import { loadEffectiveEnv, readConfig, writeConfig } from '../lib/config.js';
 import { getProcess, listProcesses } from '../lib/pbApi.js';
-import { comparePayload, decompose, recompose, stableStringify } from '../lib/pbProject.js';
+import { checksumOfPayload, comparePayload, decompose, recompose } from '../lib/pbProject.js';
 import { projectReader, writeProject } from '../lib/pbWorkspace.js';
 
 async function clonePb(opts) {
@@ -16,11 +16,11 @@ async function clonePb(opts) {
         throw new Error('PB_URL is not configured. Run `prbot init` or set it in agrippa.yaml.');
     }
 
-    console.log('Fetching process list...');
+    log('Fetching process list...');
     const token = await getToken();
     const processes = await listProcesses(token);
     if (!processes.length) {
-        console.log('No process-builder wizards found.');
+        log('No process-builder wizards found.');
         return;
     }
 
@@ -61,7 +61,7 @@ async function clonePb(opts) {
         dest = inputPath;
     }
 
-    console.log(`Fetching "${chosen.process_name}"...`);
+    log(`Fetching "${chosen.process_name}"...`);
     const payload = await getProcess(token, chosen.guid);
 
     const { files } = decompose(payload);
@@ -69,17 +69,17 @@ async function clonePb(opts) {
 
     const scriptCount = Object.keys(files).filter((p) => p.startsWith('scripts/')).length;
     const pageCount = Object.keys(files).filter((p) => p.startsWith('pages/')).length;
-    console.log(`Cloned to ${dest}/  (${scriptCount} script(s), ${pageCount} page(s))`);
+    log(`Cloned to ${dest}/  (${scriptCount} script(s), ${pageCount} page(s))`);
 
     // Prove the clone reconstructs the original payload (0-loss bar A) by
     // reading the files back from disk and recomposing.
     const rebuilt = recompose(projectReader(dest));
     const diffs = comparePayload(payload, rebuilt);
     if (diffs.length) {
-        console.warn('WARNING: round-trip verification found differences:');
-        diffs.forEach((d) => console.warn('  - ' + d));
+        warn('WARNING: round-trip verification found differences:');
+        diffs.forEach((d) => warn('  - ' + d));
     } else {
-        console.log('Round-trip verified: recomposed payload is identical (0 information loss).');
+        log('Round-trip verified: recomposed payload is identical (0 information loss).');
     }
 
     // Register in the workspace for later pull/push.
@@ -95,7 +95,7 @@ async function clonePb(opts) {
         name: chosen.process_name,
         // Baselines for `push` classification: checksum of the *recomposed* payload
         // (changes only when local files change) + upstream updated_date/status.
-        checksum_at_pull: computeChecksum(stableStringify(rebuilt)),
+        checksum_at_pull: checksumOfPayload(rebuilt),
         updated_date: payload.updated_date,
         status: payload.status,
     };

package/src/agrippa/commands/diff.js

@@ -12,6 +12,7 @@ import {
 import { tmpdir } from 'os';
 import { join } from 'path';
 import { getToken } from '../../lib/auth.js';
+import { error, log } from '../../lib/logger.js';
 import { computeChecksum } from '../lib/checksum.js';
 import { loadEffectiveEnv, readConfig } from '../lib/config.js';
 import { getProcess } from '../lib/pbApi.js';
@@ -25,13 +26,13 @@ async function diff(targetArg) {
     loadEffectiveEnv(config);
 
     if (!config.workspace.length) {
-        console.log('No tracked resources. Run `agrippa clone` first.');
+        log('No tracked resources. Run `agrippa clone` first.');
         return;
     }
 
     const entries = filterEntries(config.workspace, targetArg);
     if (!entries.length) {
-        console.log('No tracked files match the given path.');
+        log('No tracked files match the given path.');
         return;
     }
 
@@ -43,7 +44,7 @@ async function diff(targetArg) {
     if (pbEntries.length && !process.env.PB_URL)
         throw new Error('PB_URL is not configured. Run `prbot init` or set it in agrippa.yaml.');
 
-    console.log('Fetching remote code...');
+    log('Fetching remote code...');
     const token = await getToken();
 
     let diffCount = 0;
@@ -65,13 +66,13 @@ async function diff(targetArg) {
     }
 
     if (diffCount === 0) {
-        console.log('No differences found — all tracked files match the remote.');
+        log('No differences found — all tracked files match the remote.');
     } else {
         const combined = Buffer.concat(chunks);
         const pager = process.env.PAGER || 'less';
         const pagerArgs = pager === 'less' ? ['-R', '-F'] : [];
         spawnSync(pager, pagerArgs, { input: combined, stdio: ['pipe', 'inherit', 'inherit'] });
-        console.log(`\n${diffCount} file(s) differ from remote.`);
+        log(`\n${diffCount} file(s) differ from remote.`);
     }
 }
 
@@ -90,7 +91,7 @@ function diffCodeEntries(entries, remoteCodeMap) {
             if (computeChecksum(localCode) === computeChecksum(remoteCode)) continue;
 
             if (!fileExists(entry.path)) {
-                console.log(`\n--- ${entry.path} (local file missing)`);
+                log(`\n--- ${entry.path} (local file missing)`);
                 continue;
             }
 
@@ -105,7 +106,7 @@ function diffCodeEntries(entries, remoteCodeMap) {
             );
             // exit code 1 means differences found (normal), 0 means identical, >1 means error
             if (result.status !== null && result.status > 1) {
-                console.error(`git diff failed for ${entry.path}`);
+                error(`git diff failed for ${entry.path}`);
             }
             const header = Buffer.from(`\n=== ${entry.path}  [${entry.name}] ===\n`);
             chunks.push(Buffer.concat([header, result.stdout ?? Buffer.alloc(0)]));
@@ -156,7 +157,7 @@ async function diffPbEntry(token, entry) {
             { cwd: tmpRoot, stdio: ['ignore', 'pipe', 'pipe'] }
         );
         if (result.status !== null && result.status > 1) {
-            console.error(`git diff failed for ${entry.path}`);
+            error(`git diff failed for ${entry.path}`);
         }
         const header = Buffer.from(`\n=== ${entry.path}  [${entry.name}] (process-builder) ===\n`);
         const chunk = Buffer.concat([header, result.stdout ?? Buffer.alloc(0)]);

package/src/agrippa/commands/init.js

@@ -9,6 +9,7 @@ import {
 import { join } from 'path';
 import { fileURLToPath } from 'url';
 import inquirer from 'inquirer';
+import { log } from '../../lib/logger.js';
 import { WORKSPACE_FILE } from '../lib/config.js';
 
 const TEMPLATE = `# agrippa workspace configuration
@@ -93,23 +94,23 @@ async function init() {
             },
         ]);
         if (!overwrite) {
-            console.log('Skipped workspace file.');
+            log('Skipped workspace file.');
         } else {
             writeFileSync(WORKSPACE_FILE, TEMPLATE, 'utf-8');
-            console.log(`Created ${WORKSPACE_FILE}`);
-            console.log(`Run 'agrippa clone' to add resources to this workspace.`);
-            console.log(`Add ${WORKSPACE_FILE} to .gitignore if it contains credentials.`);
+            log(`Created ${WORKSPACE_FILE}`);
+            log(`Run 'agrippa clone' to add resources to this workspace.`);
+            log(`Add ${WORKSPACE_FILE} to .gitignore if it contains credentials.`);
         }
     } else {
         writeFileSync(WORKSPACE_FILE, TEMPLATE, 'utf-8');
-        console.log(`Created ${WORKSPACE_FILE}`);
-        console.log(`Run 'agrippa clone' to add resources to this workspace.`);
-        console.log(`Add ${WORKSPACE_FILE} to .gitignore if it contains credentials.`);
+        log(`Created ${WORKSPACE_FILE}`);
+        log(`Run 'agrippa clone' to add resources to this workspace.`);
+        log(`Add ${WORKSPACE_FILE} to .gitignore if it contains credentials.`);
     }
 
     if (!existsSync('pyproject.toml')) {
         writeFileSync('pyproject.toml', PYPROJECT_TOML, 'utf-8');
-        console.log('Created pyproject.toml (ruff builtins)');
+        log('Created pyproject.toml (ruff builtins)');
     }
 
     const { importTypings } = await inquirer.prompt([
@@ -124,7 +125,7 @@ async function init() {
     if (importTypings) {
         if (!existsSync('pyrightconfig.json')) {
             writeFileSync('pyrightconfig.json', PYRIGHTCONFIG, 'utf-8');
-            console.log('Created pyrightconfig.json');
+            log('Created pyrightconfig.json');
         }
 
         const typingsDir = fileURLToPath(new URL('../../../agrippa_typings', import.meta.url));
@@ -132,7 +133,7 @@ async function init() {
         for (const file of TYPING_FILES) {
             copyFileSync(join(typingsDir, file), join('typings', file));
         }
-        console.log(`Copied ${TYPING_FILES.length} type stubs to typings/`);
+        log(`Copied ${TYPING_FILES.length} type stubs to typings/`);
     }
 
     const { importInstructions } = await inquirer.prompt([
@@ -149,13 +150,13 @@ async function init() {
         const block = pbBlock(readFileSync(guidePath, 'utf-8'));
         if (!existsSync('CLAUDE.md')) {
             writeFileSync('CLAUDE.md', block, 'utf-8');
-            console.log('Created CLAUDE.md with agrippa-pb guidance');
+            log('Created CLAUDE.md with agrippa-pb guidance');
         } else {
             const current = readFileSync('CLAUDE.md', 'utf-8');
             const begin = current.indexOf(PB_BEGIN);
             if (begin === -1) {
                 appendFileSync('CLAUDE.md', `\n${block}`, 'utf-8');
-                console.log('Appended agrippa-pb guidance to CLAUDE.md');
+                log('Appended agrippa-pb guidance to CLAUDE.md');
             } else {
                 // Replace the existing managed block in place; leave the rest as-is.
                 const endIdx = current.indexOf(PB_END, begin);
@@ -165,7 +166,7 @@ async function init() {
                     );
                 const after = current.slice(endIdx + PB_END.length).replace(/^\n/, '');
                 writeFileSync('CLAUDE.md', current.slice(0, begin) + block + after, 'utf-8');
-                console.log('Refreshed agrippa-pb guidance in CLAUDE.md');
+                log('Refreshed agrippa-pb guidance in CLAUDE.md');
             }
         }
     }

package/src/agrippa/commands/initPhase.js

@@ -2,6 +2,7 @@ import search from '@inquirer/search';
 import inquirer from 'inquirer';
 import { getToken } from '../../lib/auth.js';
 import { fuzzyMatch } from '../../lib/fuzzy.js';
+import { log } from '../../lib/logger.js';
 import {
     createConfigurator,
     deleteConfigurator,
@@ -75,12 +76,12 @@ async function initPhase() {
     if (!ripUrl)
         throw new Error('RIP_URL is not configured. Run `prbot init` or set it in agrippa.yaml.');
 
-    console.log('Fetching workflows...');
+    log('Fetching workflows...');
     const token = await getToken();
     const workflows = await listWorkflows(token, ripUrl);
 
     if (!workflows.length) {
-        console.log('No workflows found.');
+        log('No workflows found.');
         return;
     }
 
@@ -92,11 +93,11 @@ async function initPhase() {
         },
     });
 
-    console.log(`Fetching phases for "${workflow.name}"...`);
+    log(`Fetching phases for "${workflow.name}"...`);
     const phases = await getPhasesByWorkflow(token, ripUrl, workflow.id);
 
     if (!phases.length) {
-        console.log('No phases found for this workflow.');
+        log('No phases found for this workflow.');
         return;
     }
 
@@ -111,7 +112,7 @@ async function initPhase() {
     ]);
 
     if (!selectedPhases.length) {
-        console.log('No phases selected. Aborted.');
+        log('No phases selected. Aborted.');
         return;
     }
 
@@ -125,7 +126,7 @@ async function initPhase() {
     ]);
 
     if (!confirm) {
-        console.log('Aborted.');
+        log('Aborted.');
         return;
     }
 
@@ -157,15 +158,13 @@ async function initPhase() {
             });
         }
 
-        console.log(`Initialized phase "${phase.name}".`);
+        log(`Initialized phase "${phase.name}".`);
         if (results.length > 0) {
-            console.log(`  ${results.length} configurator(s) created: ${vars.join(', ')}`);
+            log(`  ${results.length} configurator(s) created: ${vars.join(', ')}`);
         }
     }
 
-    console.log(
-        `Run 'agrippa pull' in workspaces that track this workflow to fetch the updated code.`
-    );
+    log(`Run 'agrippa pull' in workspaces that track this workflow to fetch the updated code.`);
 }
 
 export { initPhase };

package/src/agrippa/commands/pb.js

@@ -18,6 +18,7 @@ import { dirname, join } from 'path';
 import search from '@inquirer/search';
 import { parse as yamlParse } from 'yaml';
 import { fuzzyMatch } from '../../lib/fuzzy.js';
+import { log, warn } from '../../lib/logger.js';
 import { readConfig } from '../lib/config.js';
 import {
     addNode,
@@ -120,7 +121,7 @@ function validate(dir) {
     try {
         recompose(projectReader(dir));
     } catch (e) {
-        console.warn(`WARNING: project no longer recomposes cleanly: ${e.message}`);
+        warn(`WARNING: project no longer recomposes cleanly: ${e.message}`);
     }
 }
 
@@ -139,13 +140,13 @@ async function pbFormat(opts) {
         if (!n.layout) missing++;
     });
     validate(dir);
-    console.log(
+    log(
         `Formatted ${dir} (${nodes} node(s) laid out${missing ? `, ${missing} without layout` : ''}).`
     );
     const issues = lintAll(structure);
     if (issues.length) {
-        console.warn('Diagram issues:');
-        for (const w of issues) console.warn(`  ! ${w}`);
+        warn('Diagram issues:');
+        for (const w of issues) warn(`  ! ${w}`);
     }
 }
 
@@ -180,13 +181,13 @@ async function pbAdd(opts) {
         saveStructure(dir, structure);
         saveManifest(dir, manifest);
         validate(dir);
-        console.log(
+        log(
             `Added ${result.type} ${result.id}${result.file ? ` (${result.file})` : ''} between ${opts.from} → ${opts.to}.`
         );
-        console.log(`  ${opts.from} → ${result.id}  (${result.edgeId}, retargeted)`);
-        console.log(`  ${result.id} → ${opts.to}  (${result.newEdgeId})`);
-        for (const w of result.warnings || []) console.warn(`  ! ${w}`);
-        console.log('Run `agrippa pb format` to lay it out.');
+        log(`  ${opts.from} → ${result.id}  (${result.edgeId}, retargeted)`);
+        log(`  ${result.id} → ${opts.to}  (${result.newEdgeId})`);
+        for (const w of result.warnings || []) warn(`  ! ${w}`);
+        log('Run `agrippa pb format` to lay it out.');
         return;
     }
 
@@ -200,10 +201,8 @@ async function pbAdd(opts) {
     saveStructure(dir, structure);
     saveManifest(dir, manifest);
     validate(dir);
-    console.log(`Added ${result.type} ${result.id}${result.file ? ` (${result.file})` : ''}.`);
-    console.log(
-        'Connect it with `agrippa pb connect`, then run `agrippa pb format` to lay it out.'
-    );
+    log(`Added ${result.type} ${result.id}${result.file ? ` (${result.file})` : ''}.`);
+    log('Connect it with `agrippa pb connect`, then run `agrippa pb format` to lay it out.');
 }
 
 async function pbRemove(opts) {
@@ -215,7 +214,7 @@ async function pbRemove(opts) {
     saveStructure(dir, structure);
     saveManifest(dir, manifest);
     validate(dir);
-    console.log(
+    log(
         `Removed ${result.removed.length} node(s) [${result.removed.join(', ')}], ` +
             `${result.removedEdges} dangling edge(s), ${deletes.length} file(s).`
     );
@@ -235,11 +234,11 @@ async function pbConnect(opts) {
     });
     saveStructure(dir, structure);
     validate(dir);
-    console.log(
+    log(
         `Connected ${result.from} → ${result.to} (${result.id})${opts.default ? ' [default]' : ''}.`
     );
-    for (const w of result.warnings || []) console.warn(`  ! ${w}`);
-    console.log('Run `agrippa pb format` to route it.');
+    for (const w of result.warnings || []) warn(`  ! ${w}`);
+    log('Run `agrippa pb format` to route it.');
 }
 
 async function pbDisconnect(opts) {
@@ -250,7 +249,7 @@ async function pbDisconnect(opts) {
     const { result } = disconnect(structure, { id: opts.id, from: opts.from, to: opts.to });
     saveStructure(dir, structure);
     validate(dir);
-    console.log(`Removed ${result.removed} edge(s)${result.id ? ` (${result.id})` : ''}.`);
+    log(`Removed ${result.removed} edge(s)${result.id ? ` (${result.id})` : ''}.`);
 }
 
 async function pbSetDefault(opts) {
@@ -261,11 +260,11 @@ async function pbSetDefault(opts) {
     const { result } = setDefault(structure, { id: opts.id, from: opts.from, to: opts.to });
     saveStructure(dir, structure);
     validate(dir);
-    console.log(
+    log(
         `Default flow on ${result.from} is now ${result.id} (→ ${result.to})` +
             `${result.prev && result.prev !== result.id ? `, was ${result.prev}` : ''}.`
     );
-    for (const w of result.warnings || []) console.warn(`  ! ${w}`);
+    for (const w of result.warnings || []) warn(`  ! ${w}`);
 }
 
 async function pbList(opts) {
@@ -275,7 +274,7 @@ async function pbList(opts) {
     for (const r of rows) {
         const where = r.parent ? `  [in ${r.parent}]` : '';
         const label = r.name ? `  "${r.name}"` : '';
-        console.log(`${r.id}  (${r.type})${label}${where}`);
+        log(`${r.id}  (${r.type})${label}${where}`);
         for (const e of r.edges) {
             const tag = [
                 e.isDefault && '[default]',
@@ -284,10 +283,10 @@ async function pbList(opts) {
             ]
                 .filter(Boolean)
                 .join(' ');
-            console.log(`    → ${e.target}  (${e.id})${tag ? `  ${tag}` : ''}`);
+            log(`    → ${e.target}  (${e.id})${tag ? `  ${tag}` : ''}`);
         }
     }
-    console.log(`\n${rows.length} node(s).`);
+    log(`\n${rows.length} node(s).`);
 }
 
 async function pbPreview(opts) {
@@ -296,7 +295,7 @@ async function pbPreview(opts) {
     const svg = toSvg(structure);
     const out = opts.out || join(dir, 'preview.svg');
     writeFileSync(out, svg, 'utf-8');
-    console.log(`Wrote ${out} (${svg.length} bytes).`);
+    log(`Wrote ${out} (${svg.length} bytes).`);
 }
 
 async function pbLint(opts) {
@@ -304,9 +303,9 @@ async function pbLint(opts) {
     const { structure } = loadProject(dir);
     const issues = lintAll(structure);
     if (!issues.length) {
-        console.log('No issues.');
+        log('No issues.');
     } else {
-        for (const w of issues) console.warn(`  ! ${w}`);
+        for (const w of issues) warn(`  ! ${w}`);
         process.exitCode = 1;
     }
 }