@vincentt-xr/cli 0.5.1 → 0.7.0

package/dist/preview/copy.d.ts

@@ -139,6 +139,18 @@ export declare function hardMaxWarning(clockTime: string, minutesLeft: number):
 export declare function hardMaxReached(): string[];
 /** c. Superseded — the terminal that LOST. */
 export declare function supersededLoser(): string[];
+/**
+ * Re-running `vincentt preview` on a folder that already has one attaches to it
+ * rather than minting a second — but a caller who is not SHOWN the link cannot
+ * tell the difference between "attached" and "failed to give me a URL". The
+ * reported behavior was an agent re-running preview until it saw a link, and
+ * each of those re-runs superseded the previous session: the link really did
+ * keep changing, because the attach never printed one.
+ *
+ * The URL renders bare on its own line, matching the start block, so anything
+ * scraping for a link finds it in the same shape either way.
+ */
+export declare function attachedToRunning(url: string, expiresAt?: string): string[];
 /**
  * c. Superseded — the terminal that WON. This sits ABOVE the `✓ Preview is live`
  * block so the consequence is read before the URL is copied.

package/dist/preview/copy.js

@@ -299,6 +299,28 @@ export function supersededLoser() {
         "",
     ];
 }
+/**
+ * Re-running `vincentt preview` on a folder that already has one attaches to it
+ * rather than minting a second — but a caller who is not SHOWN the link cannot
+ * tell the difference between "attached" and "failed to give me a URL". The
+ * reported behavior was an agent re-running preview until it saw a link, and
+ * each of those re-runs superseded the previous session: the link really did
+ * keep changing, because the attach never printed one.
+ *
+ * The URL renders bare on its own line, matching the start block, so anything
+ * scraping for a link finds it in the same shape either way.
+ */
+export function attachedToRunning(url, expiresAt) {
+    const lines = ["", "→ A preview is already running for this folder.", "", url, ""];
+    // Stated only when known: a marker written by an older CLI has no expiry, and
+    // inventing one would be the over-claim this copy exists to avoid.
+    if (expiresAt !== undefined) {
+        lines.push(`  This link is good until ${expiresAt}.`);
+    }
+    lines.push("  Start a fresh one:  vincentt preview --restart");
+    lines.push("");
+    return lines;
+}
 /**
  * c. Superseded — the terminal that WON. This sits ABOVE the `✓ Preview is live`
  * block so the consequence is read before the URL is copied.

package/dist/preview/runner.d.ts

@@ -33,6 +33,19 @@ export type PreviewEndReason = "stopped"
 export interface StartPreviewOptions {
     /** Project directory — its .vincentt binding + dev script drive the preview. */
     projectCwd: string;
+    /**
+     * The directory holding the binding — the tree's IDENTITY, as distinct from
+     * the directory the dev server runs in.
+     *
+     * These differ whenever a creator runs `vincentt preview` from a subdirectory
+     * of a bound repo: `locateProjectBinding` walks up to find the binding, so the
+     * same project resolves from `apps/web/` and from the repo root. Keying the
+     * one-session-per-tree rule off the raw cwd made those two spellings two
+     * trees, which is precisely what `workingTreeKey` normalizes symlinks and
+     * relative paths to prevent. Defaults to projectCwd when the caller has not
+     * located a binding.
+     */
+    projectRoot?: string;
     /** The API host + PAT. Resolved by the caller so the runner makes no policy. */
     config: ResolvedConfig;
     projectId: string;

package/dist/preview/runner.js

@@ -22,7 +22,7 @@ import { getFreePort, isPortListening, waitForApp } from "./net.js";
 import { endPreviewSession, heartbeatPreviewSession, mintPreviewSession, workingTreeKey, PreviewEndedError, } from "./api.js";
 import { ProjectUnreachableError } from "../lib/backend.js";
 export async function startPreview(opts) {
-    const { projectCwd, config, projectId, harnessPath = "/__harness", devCommand = ["npm", "run", "dev"], appStdio = "ignore", appReadyTimeoutMs = 8_000, onLog = () => undefined, fetchImpl = fetch, } = opts;
+    const { projectCwd, projectRoot = projectCwd, config, projectId, harnessPath = "/__harness", devCommand = ["npm", "run", "dev"], appStdio = "ignore", appReadyTimeoutMs = 8_000, onLog = () => undefined, fetchImpl = fetch, } = opts;
     const appPort = opts.appPort ?? 5173;
     const relayPort = opts.relayPort ?? (await getFreePort());
     const frontPort = opts.frontPort ?? (await getFreePort());
@@ -56,7 +56,9 @@ export async function startPreview(opts) {
         // The MINT comes first. Everything below it costs the creator a dev-server
         // start and a port; if the mint is going to fail — rate limit, revoked
         // membership, no binding — it should fail before any of that happens.
-        const key = await workingTreeKey(projectCwd);
+        // Keyed on the tree's identity, not the folder the command was typed in:
+        // the supersede rule must see one tree however the creator addressed it.
+        const key = await workingTreeKey(projectRoot);
         minted = await mintPreviewSession(config, projectId, key, fetchImpl);
         if (reuseApp) {
             onLog(`reusing the dev server already on :${appPort}`);
@@ -73,7 +75,10 @@ export async function startPreview(opts) {
         relay = startRelay({
             port: relayPort,
             path: harnessPath,
-            projectDir: projectCwd,
+            // Annotations land beside the binding, so `vincentt feedback` finds them
+            // from anywhere in the tree rather than only from the folder that started
+            // the preview.
+            projectDir: projectRoot,
             onLog: (m) => onLog(`[relay] ${m}`),
             onEvents: opts.onEvents,
             onAttribute: opts.onAttribute,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincentt-xr/cli",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Vincentt CLI — the vincentt command-line dev loop (login, create, publish, preview, diagnostics, feedback, relay)",
   "license": "UNLICENSED",
   "type": "module",