dsh-hashline-edit 0.2.0 → 0.2.2

package/src/preview-controller.ts

@@ -0,0 +1,84 @@
+import { getPreviewInput, type RPreview, type RRState } from "./edit-render.js";
+
+export const PREVIEW_DEBOUNCE_MS = 150;
+
+export interface PreviewHost {
+  cwd: string;
+  executionStarted: boolean;
+  argsComplete: boolean;
+  state: RRState;
+  invalidate: () => void;
+}
+
+export type PreviewCompute = (args: unknown, cwd: string) => Promise<RPreview>;
+
+// SAFETY: large-class — cohesive store owns DB and cache as single owner; split would scatter invariants.
+export class DebouncedPreview {
+  constructor(
+    private readonly compute: PreviewCompute,
+    private readonly debounceMs: number = PREVIEW_DEBOUNCE_MS,
+    private readonly getSessionId?: () => string | undefined,
+  ) {}
+
+  renderCall(host: PreviewHost, args: unknown): void {
+    const { state } = host;
+    const previewInput = getPreviewInput(args);
+    if (host.executionStarted || !host.argsComplete || !previewInput) {
+      this.cancel(state);
+      return;
+    }
+    const argsKey = JSON.stringify(previewInput);
+    if (state.argsKey === argsKey) return;
+    this.cancel(state);
+    state.argsKey = argsKey;
+    const previewGeneration = (state.previewGeneration ?? 0) + 1;
+    state.previewGeneration = previewGeneration;
+    // WHY: (#168-class) the compute's session is bound at arm time: if the serving session
+    // WHY: changed before the timer fires, verifying these anchors against the new session
+    // WHY: would mint a false E_UNKNOWN_ANCHOR, so the stale compute is dropped (cancelled)
+    // WHY: and the next renderCall re-arms against the session that actually serves anchors.
+    const armedSessionId = this.getSessionId?.();
+    state.previewTimer = setTimeout(() => {
+      delete state.previewTimer;
+      if (this.getSessionId && this.getSessionId() !== armedSessionId) {
+        this.cancel(state);
+        host.invalidate();
+        return;
+      }
+      this.compute(args, host.cwd)
+        .then((preview) => {
+          if (state.argsKey === argsKey && state.previewGeneration === previewGeneration) {
+            state.preview = preview;
+            host.invalidate();
+          }
+        })
+        .catch((err: unknown) => {
+          if (state.argsKey === argsKey && state.previewGeneration === previewGeneration) {
+            state.preview = {
+              error: err instanceof Error ? err.message : String(err),
+            };
+            host.invalidate();
+          }
+        });
+    }, this.debounceMs);
+  }
+
+  cancel(state: RRState): void {
+    if (state.previewTimer) {
+      clearTimeout(state.previewTimer);
+      delete state.previewTimer;
+    }
+    delete state.argsKey;
+    delete state.preview;
+    state.previewGeneration = (state.previewGeneration ?? 0) + 1;
+  }
+
+  clearResult(state: RRState): void {
+    if (state.previewTimer) {
+      clearTimeout(state.previewTimer);
+      delete state.previewTimer;
+    }
+    delete state.preview;
+    state.previewGeneration = (state.previewGeneration ?? 0) + 1;
+  }
+}

package/src/prompts.ts

@@ -1,23 +1,56 @@
 import { readFileSync } from "node:fs";
+import { HASH_LEN } from "./hashline/alphabet.js";
+import {
+  ANCHOR_EXAMPLE,
+  EDIT_DESCRIPTION,
+  EDIT_SNIPPET,
+  EDIT_GUIDELINES,
+} from "./payload-contract.js";
 
-export function loadP(relativePath: string, replacements?: Record<string, string>): string {
-  let content = readFileSync(new URL(relativePath, import.meta.url), "utf-8").trim();
+/**
+ * Resolve template variables in shipped prompt prose. Beyond caller-supplied replacements, the
+ * anchor-width token and its example are ALWAYS resolved from the live HASH_LEN: the width is a
+ * build-time setting (ADR-0020), so any prompt that quotes it must not hardcode a digit.
+ */
+function applyReplacements(content: string, replacements?: Record<string, string>): string {
+  let out = content;
   if (replacements) {
     for (const [key, value] of Object.entries(replacements)) {
-      content = content.split(`{{${key}}}`).join(value);
+      out = out.split(`{{${key}}}`).join(value);
     }
   }
-  return content;
+  return out
+    .split("{{HASH_LEN}}")
+    .join(String(HASH_LEN))
+    .split("{{ANCHOR_EXAMPLE}}")
+    .join(ANCHOR_EXAMPLE);
+}
+
+const EDIT_PROMPT_FILES = new Set([
+  "../prompts/edit.md",
+  "prompts/edit.md",
+  "../prompts/edit-snippet.md",
+  "prompts/edit-snippet.md",
+]);
+
+const EDIT_GUIDE_FILES = new Set(["../prompts/edit-guidelines.md", "prompts/edit-guidelines.md"]);
+
+export function loadP(relativePath: string, replacements?: Record<string, string>): string {
+  if (EDIT_PROMPT_FILES.has(relativePath)) {
+    const content = relativePath.includes("snippet") ? EDIT_SNIPPET : EDIT_DESCRIPTION;
+    return applyReplacements(content, replacements);
+  }
+  const content = readFileSync(new URL(relativePath, import.meta.url), "utf-8").trim();
+  return applyReplacements(content, replacements);
 }
 
 export function loadGuide(relativePath: string, replacements?: Record<string, string>): string[] {
-  let content = readFileSync(new URL(relativePath, import.meta.url), "utf-8");
-  if (replacements) {
-    for (const [key, value] of Object.entries(replacements)) {
-      content = content.split(`{{${key}}}`).join(value);
-    }
+  if (EDIT_GUIDE_FILES.has(relativePath)) {
+    const guidelines = [...EDIT_GUIDELINES];
+    return guidelines.map((line) => applyReplacements(line, replacements));
   }
-  return content
+  const content = readFileSync(new URL(relativePath, import.meta.url), "utf-8");
+  return applyReplacements(content, replacements)
     .split("\n")
     .map((line) => line.trim())
     .filter((line) => line.startsWith("- "))