@karmaniverous/stan-cli 0.11.2 → 0.11.3

package/dist/cli/stan.js

@@ -17153,6 +17153,25 @@ const readDocsMeta = async (cwd, stanPath) => {
     }
     return null;
 };
+const updateDocsMetaPrompt = async (cwd, stanPath, prompt) => {
+    const p = metaPath(cwd, stanPath);
+    let base = {};
+    try {
+        const raw = await readFile(p, 'utf8');
+        const v = JSON.parse(raw);
+        if (v && typeof v === 'object')
+            base = v;
+    }
+    catch {
+        base = {};
+    }
+    const next = {
+        ...base,
+        prompt: { ...(base.prompt ?? {}), ...prompt },
+    };
+    await ensureDir(path.dirname(p));
+    await writeFile(p, JSON.stringify(next, null, 2), 'utf8');
+};
 const updateDocsMetaOverlay = async (cwd, stanPath, overlay) => {
     const p = metaPath(cwd, stanPath);
     let base = {};
@@ -28897,6 +28916,18 @@ const flushUiOnce = async (ui) => {
     }
 };
 
+/* src/stan/util/hash.ts
+ * SHA-256 hashing helper for file paths.
+ */
+/**
+ * Compute the SHA-256 hash (hex) of a file's bytes.
+ */
+const sha256File = async (abs) => {
+    return createHash('sha256')
+        .update(await readFile(abs))
+        .digest('hex');
+};
+
 /** Build FULL and DIFF base configs; DIFF intentionally excludes anchors. */
 const makeBaseConfigs = (config) => {
     const full = {
@@ -29183,18 +29214,6 @@ const buildArchiveProgress = (ui, cwd) => {
     };
 };
 
-/* src/stan/util/hash.ts
- * SHA-256 hashing helper for file paths.
- */
-/**
- * Compute the SHA-256 hash (hex) of a file's bytes.
- */
-const sha256File = async (abs) => {
-    return createHash('sha256')
-        .update(await readFile(abs))
-        .digest('hex');
-};
-
 // src/runner/run/session/archive-stage/prompt-ephemeral.ts
 /** True when the resolved prompt source is not the local system file. */
 const isEphemeralPrompt = (systemAbs, promptAbs) => {
@@ -29214,8 +29233,8 @@ const isEphemeralPrompt = (systemAbs, promptAbs) => {
  */
 const decideIncludeOnChange = async (args) => {
     const { cwd, stanPath, promptAbs } = args;
-    // Default to include once when we cannot decide safely
-    let includeOnChange = true;
+    // Default to suppress when we cannot decide safely (no baseline yet).
+    let includeOnChange = false;
     let currentHash;
     try {
         if (promptAbs)
@@ -29233,14 +29252,14 @@ const decideIncludeOnChange = async (args) => {
             includeOnChange = baseline !== currentHash;
         }
         else if (!baseline) {
-            includeOnChange = true;
+            includeOnChange = false;
         }
         else if (!currentHash) {
             includeOnChange = false;
         }
     }
     catch {
-        includeOnChange = true;
+        includeOnChange = false;
     }
     return includeOnChange;
 };
@@ -29469,28 +29488,55 @@ const preparePromptOrThrow = async (args) => {
 };
 
 /**
-+ * Unified archive runner (ephemeral and non‑ephemeral).
- *+  - Ephemeral:
- *+    • includeOnChange=true: inject BEFORE diff so prompt appears exactly once in diff; then full.
- *+    • includeOnChange=false: quiet diff first; inject ONLY for full.
- *+  - Non‑ephemeral:
- *+    • prepare once when needed; run diff then full; restore afterward.
+ * Normalize an imports map so that all values are concrete string[].
+ * Drops entries with undefined values and returns null when empty.
+ */
+const normalizeImportsMap = (m) => {
+    if (!m)
+        return m;
+    const out = {};
+    for (const [k, v] of Object.entries(m)) {
+        if (Array.isArray(v))
+            out[k] = v;
+    }
+    return Object.keys(out).length ? out : null;
+};
+/**
+ * Unified archive runner (ephemeral and non‑ephemeral).
+ *  - Ephemeral:
+ *    • includeOnChange=true: inject BEFORE diff so prompt appears exactly once in diff; then full.
+ *    • includeOnChange=false: quiet diff first; inject ONLY for full.
+ *  - Non‑ephemeral:
+ *    • prepare once when needed; run diff then full; restore afterward.
  */
 const runArchiveUnified = async (args) => {
     const { cwd, stanPath, behavior, promptAbs, promptDisplay, baseFull, baseDiff, archivePhase, stageImports, preparePrompt, prepareIfNeeded, shouldContinue, progress, ephemeral, includeOnChange, importsMap, } = args;
     const created = [];
     const includeOutputs = Boolean(behavior.combine);
+    const posix = (p) => p.replace(/\\+/g, '/');
     // Optional imports staging (ephemeral path stages once for both passes)
     if (ephemeral && typeof stageImports === 'function') {
         if (typeof shouldContinue !== 'function' || shouldContinue())
-            await stageImports(cwd, stanPath, importsMap);
+            await stageImports(cwd, stanPath, normalizeImportsMap(importsMap));
         else
             return created;
     }
     const runDiff = async () => {
         if (typeof shouldContinue === 'function' && !shouldContinue())
             return;
-        const d = await archivePhase({ cwd, config: baseDiff, includeOutputs }, { silent: true, which: 'diff', progress, shouldContinue });
+        // Quiet DIFF when the prompt is unchanged:
+        // Exclude stan.system.md to neutralize snapshot residue (whether the prompt
+        // source is ephemeral or local) so DIFF doesn't reintroduce or delete it.
+        const diffCfg = includeOnChange === false
+            ? {
+                ...baseDiff,
+                excludes: [
+                    ...(baseDiff.excludes ?? []),
+                    posix(`${stanPath}/system/stan.system.md`),
+                ],
+            }
+            : baseDiff;
+        const d = await archivePhase({ cwd, config: diffCfg, includeOutputs }, { silent: true, which: 'diff', progress, shouldContinue });
         if (d.diffPath)
             created.push(d.diffPath);
     };
@@ -29553,7 +29599,7 @@ const runArchiveUnified = async (args) => {
 };
 
 const runArchiveStage = async (args) => {
-    const { cwd, config, behavior, ui, promptAbs, promptDisplay } = args;
+    const { cwd, config, behavior, ui, promptAbs, promptDisplay, promptSource } = args;
     const shouldContinue = typeof args.shouldContinue === 'function'
         ? args.shouldContinue
         : () => true;
@@ -29566,6 +29612,22 @@ const runArchiveStage = async (args) => {
     const systemAbs = path.join(cwd, config.stanPath, 'system', 'stan.system.md');
     const { full: baseFull, diff: baseDiff } = makeBaseConfigs(config);
     const progress = buildArchiveProgress(ui, cwd);
+    // Persist the prompt baseline best-effort (source + hash + path).
+    const persistPromptBaseline = async () => {
+        try {
+            if (!promptAbs || !promptSource)
+                return;
+            const hash = await sha256File(promptAbs);
+            await updateDocsMetaPrompt(cwd, config.stanPath, {
+                source: promptSource,
+                hash,
+                path: promptAbs,
+            });
+        }
+        catch {
+            /* best-effort */
+        }
+    };
     const ephemeral = isEphemeralPrompt(systemAbs, promptAbs);
     if (ephemeral) {
         if (!shouldContinue())
@@ -29612,6 +29674,7 @@ const runArchiveStage = async (args) => {
                 importsMap: config.imports,
             });
             created.push(...out);
+            await persistPromptBaseline();
             return { created, cancelled: false };
         }
         catch (e) {
@@ -29655,6 +29718,7 @@ const runArchiveStage = async (args) => {
             ephemeral: false,
         });
         created.push(...out);
+        await persistPromptBaseline();
         return { created, cancelled: false };
     }
     catch (e) {
@@ -29952,7 +30016,9 @@ const printPlanWithPrompt = (cwd, args) => {
     console.log('');
 };
 
-// src/runner/run/session/run-session/steps/prompt.ts
+/* src/stan/run/session/run-session/steps/prompt.ts
+ * Prompt resolution and plan printing (with prompt line).
+ */
 /**
  * Resolve the prompt to use and (optionally) print the plan with the resolved prompt line.
  *
@@ -29966,10 +30032,12 @@ function resolvePromptAndMaybePrintPlan(args) {
     const { cwd, config, selection, mode, behavior, ui, planBody, printPlan, promptChoice, } = args;
     let resolvedPromptDisplay = '';
     let resolvedPromptAbs = null;
+    let resolvedPromptSource = null;
     try {
         const rp = resolvePromptOrThrow(cwd, config.stanPath, promptChoice);
         resolvedPromptDisplay = rp.display;
         resolvedPromptAbs = rp.abs;
+        resolvedPromptSource = rp.kind;
         try {
             if (process.env.STAN_DEBUG === '1') {
                 const srcKind = rp.kind ||
@@ -29988,6 +30056,7 @@ function resolvePromptAndMaybePrintPlan(args) {
         console.log('');
         resolvedPromptDisplay = 'auto (unresolved)';
         resolvedPromptAbs = null;
+        resolvedPromptSource = null;
     }
     if (printPlan && planBody) {
         try {
@@ -30005,7 +30074,11 @@ function resolvePromptAndMaybePrintPlan(args) {
             /* ignore plan print failure */
         }
     }
-    return { display: resolvedPromptDisplay, abs: resolvedPromptAbs };
+    return {
+        display: resolvedPromptDisplay,
+        abs: resolvedPromptAbs,
+        source: resolvedPromptSource,
+    };
 }
 
 /**
@@ -30099,7 +30172,7 @@ const runSessionOnce = async (args) => {
     // Optional order file (tests)
     const orderFile = await ensureOrderFile(shouldWriteOrder, outAbs, Boolean(behavior.keep));
     // Resolve prompt & maybe print plan; then start UI and ensure a first frame
-    const { display: resolvedPromptDisplay, abs: resolvedPromptAbs } = resolvePromptAndMaybePrintPlan({
+    const { display: resolvedPromptDisplay, abs: resolvedPromptAbs} = resolvePromptAndMaybePrintPlan({
         cwd,
         config,
         selection,