Fix Sigil CLI import on Python 3.12+

.gitignore

@@ -18,7 +18,6 @@ venv/
 node_modules/
 npm/lib/
 /tools/sigil-vscode/out/
-/tools/sigil-vscode/package-lock.json
 
 # Paperclip agents (not part of product)
 agents/

npm/package.json

@@ -29,7 +29,7 @@
     "url": "https://github.com/fielding/sigil/issues"
   },
   "scripts": {
-    "prepublishOnly": "bash prepare.sh"
+    "prepublishOnly": "node prepare.mjs"
   },
   "engines": {
     "node": ">=18"

npm/prepare.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// Copy Sigil runtime assets into the npm package for distribution.
+// Keep this dependency-free so the publish lifecycle is portable and auditable.
+
+import { copyFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const repoRoot = join(scriptDir, '..');
+
+function copyFile(source, destination, label) {
+  mkdirSync(dirname(destination), { recursive: true });
+  copyFileSync(source, destination);
+  console.log(`Copied ${label}`);
+}
+
+copyFile(
+  join(repoRoot, 'tools', 'intent', 'sigil.py'),
+  join(scriptDir, 'lib', 'sigil.py'),
+  'sigil.py to npm/lib/'
+);
+
+copyFile(
+  join(repoRoot, 'tools', 'intent_viewer', 'index.html'),
+  join(scriptDir, 'lib', 'sigil_viewer.html'),
+  'intent_viewer to npm/lib/sigil_viewer.html'
+);
+
+const demoIndexDir = join(repoRoot, 'examples', 'demo-app', '.intent', 'index');
+if (existsSync(demoIndexDir)) {
+  mkdirSync(join(scriptDir, 'lib', 'demo_index'), { recursive: true });
+  for (const file of readdirSync(demoIndexDir).filter((name) => name.endsWith('.json'))) {
+    copyFile(
+      join(demoIndexDir, file),
+      join(scriptDir, 'lib', 'demo_index', file),
+      `demo index ${file} to npm/lib/demo_index/`
+    );
+  }
+} else {
+  console.log('Skipped demo index copy; examples/demo-app/.intent/index is absent');
+}

tools/intent/sigil.py

@@ -4686,16 +4686,20 @@ def cmd_show(args) -> int:
         print(f"\n  Relationships ({len(outgoing) + len(incoming)})")
         print(f"  {'-' * 40}")
 
-        # Group by edge type
+        # Group by edge type. Keep default glyphs outside the f-string
+        # expressions so the CLI imports cleanly on Python 3.12+.
         by_type: Dict[str, List[str]] = collections.defaultdict(list)
+        default_symbol = "\u25cb"
+        outgoing_arrow = "\u2192"
+        incoming_arrow = "\u2190"
         for e in outgoing:
             if e.dst in g.nodes:
                 t = g.nodes[e.dst]
-                by_type[e.type].append(f"\u2192 {sym.get(t.type, '\u25cb')} {e.dst}  {t.title}")
+                by_type[e.type].append(f"{outgoing_arrow} {sym.get(t.type, default_symbol)} {e.dst}  {t.title}")
         for e in incoming:
             if e.src in g.nodes:
                 t = g.nodes[e.src]
-                by_type[e.type].append(f"\u2190 {sym.get(t.type, '\u25cb')} {e.src}  {t.title}")
+                by_type[e.type].append(f"{incoming_arrow} {sym.get(t.type, default_symbol)} {e.src}  {t.title}")
 
         for etype in sorted(by_type.keys()):
             print(f"    {etype}:")