@codeursenior/pek 0.1.9 → 0.1.10

package/dist/cli.js

@@ -11,7 +11,7 @@ Usage: npx @codeursenior/pek audit agent [folder] [options]
 
 Explore context, skills and MCP configuration in your default browser.
 
-  --port <number>   Choose a port (default: an available port)
+  --port <number>   Choose a port (default: 4242; 0 for an available port)
   --no-open         Print the URL without opening a browser
   --project-only    Skip user-level assets
   --help, -h        Show this help
@@ -42,7 +42,7 @@ try {
             positionals[1] !== "agent" ||
             positionals.length > 3)
             throw new Error("Expected: pek audit agent [folder]. Use --help for options.");
-        const port = values.port === undefined ? 0 : Number(values.port);
+        const port = values.port === undefined ? 4242 : Number(values.port);
         if (!Number.isInteger(port) || port < 0 || port > 65535)
             throw new Error("Port must be an integer between 0 and 65535.");
         const root = path.resolve(positionals[2] || process.cwd());
@@ -82,6 +82,6 @@ try {
     }
 }
 catch (error) {
-    console.error(`\n  ${errorCode(error) === "EADDRINUSE" ? "Port is in use. Choose another --port or omit it." : error instanceof Error ? error.message : String(error)}\n`);
+    console.error(`\n  ${errorCode(error) === "EADDRINUSE" ? "Port is in use (default: 4242). Close the other instance or choose --port <number>. Whiteboards are stored separately for each browser and port." : error instanceof Error ? error.message : String(error)}\n`);
     process.exitCode = 1;
 }

package/dist/scan/skill-graph.js

@@ -0,0 +1,39 @@
+import path from "node:path";
+import { links } from "./metadata.js";
+import { referenceResolver } from "./references.js";
+/** Explicit references only. A mention in prose is not a dependency. */
+export function skillGraph(entries, skills, env) {
+    const files = entries.filter((entry) => path.basename(entry.file) === "SKILL.md");
+    const byFile = new Map(skills.flatMap((skill) => skill.editTargets.map((target) => [target.id, skill])));
+    const resolve = referenceResolver(files, env);
+    const edges = new Map();
+    for (const entry of files) {
+        const source = byFile.get(entry.id);
+        if (!source)
+            continue;
+        const add = (target) => {
+            if (target && target.id !== source.id)
+                edges.set(`${source.id}:${target.id}`, {
+                    source: source.id,
+                    target: target.id,
+                });
+        };
+        const references = links(entry.text);
+        // Also accept unquoted paths, including absolute paths; resolve only indexed skills.
+        for (const match of entry.text.matchAll(/(?:^|[\s`(<])((?:~\/|\.{0,2}\/)?[\w.\-/À-ž]+\/SKILL\.md)(?=$|[\s`)>.,;#])/gm))
+            references.push({ target: match[1] ?? "", wiki: false });
+        for (const reference of references) {
+            const target = resolve(entry, reference);
+            if (target)
+                add(byFile.get(target.id));
+        }
+        const body = entry.text.replace(/^---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$)/, "");
+        for (const match of body.matchAll(/(?:^|[\s`(])(?:\/|\$)([a-zA-Z0-9][\w:-]*)(?=$|[\s`.,;!?)\]])/gm)) {
+            const candidates = skills.filter((skill) => skill.name === match[1]);
+            // Names shared by different skills are ambiguous; paths remain resolvable.
+            if (candidates.length === 1)
+                add(candidates[0]);
+        }
+    }
+    return [...edges.values()];
+}

package/dist/scanner.js

@@ -6,6 +6,7 @@ import { collectFiles } from "./scan/collect.js";
 import { buildGraph } from "./scan/graph.js";
 import { discoverIdentity } from "./scan/identity.js";
 import { discoverMcp } from "./scan/mcp.js";
+import { skillGraph } from "./scan/skill-graph.js";
 import { inside, slash } from "./scan/values.js";
 import { contextInventory } from "./token-estimator.js";
 /** Inventory only: never executes instructions, hooks, skills or MCP commands. */
@@ -55,6 +56,7 @@ export async function scanProject(project, options = {}) {
         rules: [...rules.values()].sort((a, b) => a.name.localeCompare(b.name)),
         edges,
         skills: [...skills.values()].sort((a, b) => a.name.localeCompare(b.name)),
+        skillEdges: skillGraph(entries, [...skills.values()], env),
         mcp,
         warnings: [...new Set(env.warnings)],
         limits: { includeUser, scannedFiles: inspected, truncated: capped },

package/docs/architecture.md

@@ -14,6 +14,8 @@ The Angular UI uses standalone OnPush components and signals. `WorkspaceState` o
 
 The detail component owns its edit draft and revision. A request sequence prevents late previews or writes from updating a different selection. The graph component delegates only its SVG subtree to the typed D3 renderer. Simulation nodes and links are copies of API data. Initial positions, layout forces and bounded warm-up are preserved; cleanup stops simulations and removes listeners when the graph is replaced or destroyed.
 
+The Skills whiteboard is a separate Angular SVG view. `scan/skill-graph.ts` resolves explicit links, paths and invocations against the indexed skill inventory, without reading arbitrary targets or inferring relations from prose. The API returns these read-only skill edges separately from context edges. Ambiguous invocations are left unconnected. `skill-board-model.ts` reconciles browser-saved placements against stable source-file identities, keeping content edits independent of placement and appending added skills beside the composition. Manual arrows and titles live only in project-keyed localStorage. Read-only source edges are rebuilt from each scan and never saved as drawings. Invalid or blocked browser storage produces a visible status; unreadable saved data is not overwritten. The CLI uses port 4242 to keep the browser origin stable; the programmatic server continues to accept ephemeral ports.
+
 ## Extending and testing
 
 - Add filesystem discovery behavior to the relevant scan module, with a synthetic fixture in the backend tests. Test normalization and reference rules as pure functions when possible; retain real filesystem tests for symlinks, scope boundaries, and limits.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeursenior/pek",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Agent Visualizer by Product Engineer Kit: explore local AI instructions, rules, skills and MCP configuration.",
   "type": "module",
   "bin": {