@jami-studio/pinpoint 0.1.12

package/src/scripts/get-pins.ts

@@ -0,0 +1,36 @@
+// @agent-native/pinpoint — List/filter annotations script
+// MIT License
+
+import { parseArgs } from "@agent-native/core/scripts";
+
+import { FileStore } from "../storage/file-store.js";
+import type { PinStatus } from "../types/index.js";
+
+export default async function (args: string[]) {
+  const { pageUrl, status } = parseArgs(args) as {
+    pageUrl?: string;
+    status?: PinStatus;
+  };
+
+  const store = new FileStore();
+  const pins = await store.list({ pageUrl, status });
+
+  if (pins.length === 0) {
+    console.log("No annotations found.");
+    return;
+  }
+
+  console.log(`Found ${pins.length} annotation(s):\n`);
+
+  for (let i = 0; i < pins.length; i++) {
+    const pin = pins[i];
+    console.log(`${i + 1}. [${pin.status.state}] ${pin.element.selector}`);
+    console.log(`   Comment: ${pin.comment}`);
+    if (pin.author) console.log(`   Author: ${pin.author}`);
+    if (pin.framework?.sourceFile)
+      console.log(`   Source: ${pin.framework.sourceFile}`);
+    console.log(`   Page: ${pin.pageUrl}`);
+    console.log(`   ID: ${pin.id}`);
+    console.log();
+  }
+}

package/src/scripts/list-sessions.ts

@@ -0,0 +1,33 @@
+// @agent-native/pinpoint — List annotation sessions by page URL
+// MIT License
+
+import { FileStore } from "../storage/file-store.js";
+
+export default async function (_args: string[]) {
+  const store = new FileStore();
+  const pins = await store.list();
+
+  // Group by page URL
+  const sessions = new Map<string, { count: number; latest: string }>();
+  for (const pin of pins) {
+    const existing = sessions.get(pin.pageUrl);
+    if (!existing || pin.updatedAt > existing.latest) {
+      sessions.set(pin.pageUrl, {
+        count: (existing?.count ?? 0) + 1,
+        latest: pin.updatedAt,
+      });
+    } else {
+      existing.count++;
+    }
+  }
+
+  if (sessions.size === 0) {
+    console.log("No annotation sessions found.");
+    return;
+  }
+
+  console.log(`${sessions.size} page(s) with annotations:\n`);
+  for (const [url, info] of sessions) {
+    console.log(`  ${url} — ${info.count} pin(s), last updated ${info.latest}`);
+  }
+}

package/src/scripts/resolve-pin.ts

@@ -0,0 +1,27 @@
+// @agent-native/pinpoint — Resolve annotation script
+// MIT License
+
+import { parseArgs, fail } from "@agent-native/core/scripts";
+
+import { FileStore } from "../storage/file-store.js";
+
+export default async function (args: string[]) {
+  const { id, message } = parseArgs(args) as {
+    id?: string;
+    message?: string;
+  };
+
+  if (!id) fail("--id is required");
+
+  const store = new FileStore();
+  await store.update(id!, {
+    status: {
+      state: "resolved",
+      changedAt: new Date().toISOString(),
+      changedBy: "agent",
+    },
+    ...(message ? { comment: message } : {}),
+  });
+
+  console.log(`Resolved annotation ${id}`);
+}

package/src/scripts/run.ts

@@ -0,0 +1,8 @@
+// @agent-native/pinpoint — Script dispatcher
+// MIT License
+//
+// Required entry point for agent scripts. Routes to specific script modules.
+
+import { runScript } from "@agent-native/core/scripts";
+
+runScript();

package/src/scripts/update-pin.ts

@@ -0,0 +1,32 @@
+// @agent-native/pinpoint — Update annotation script
+// MIT License
+
+import { parseArgs, fail } from "@agent-native/core/scripts";
+
+import { FileStore } from "../storage/file-store.js";
+
+export default async function (args: string[]) {
+  const { id, comment, status } = parseArgs(args) as {
+    id?: string;
+    comment?: string;
+    status?: string;
+  };
+
+  if (!id) fail("--id is required");
+  if (!comment && !status) fail("--comment or --status is required");
+
+  const store = new FileStore();
+  const patch: Record<string, any> = {};
+
+  if (comment) patch.comment = comment;
+  if (status) {
+    patch.status = {
+      state: status,
+      changedAt: new Date().toISOString(),
+      changedBy: "agent",
+    };
+  }
+
+  await store.update(id!, patch);
+  console.log(`Updated annotation ${id}`);
+}