@ogygie/studio 0.31.0 → 0.32.0

package/dist/server.js

@@ -1187,7 +1187,7 @@ ${deps.originOf(path)}`
 }
 
 // src/server/storage/local-adapter.ts
-import { mkdir, writeFile } from "node:fs/promises";
+import { mkdir, stat as stat2, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute as isAbsolute2, resolve as resolve2, sep as sep2 } from "node:path";
 function resolveInsideRoot2(rootDir, relativePath) {
   const root = resolve2(rootDir);
@@ -1214,6 +1214,14 @@ function createLocalSpecStorage(rootDir) {
       const absolute = resolveInsideRoot2(rootDir, path);
       await mkdir(dirname(absolute), { recursive: true });
       await writeFile(absolute, content, "utf8");
+    },
+    async modifiedAt(path) {
+      const absolute = resolveInsideRoot2(rootDir, path);
+      try {
+        return (await stat2(absolute)).mtime.toISOString();
+      } catch {
+        return null;
+      }
     }
   };
 }
@@ -1345,7 +1353,8 @@ function intentOf(body) {
   const sentence = /^.*?[.!?](?:\s|$)/u.exec(paragraph)?.[0]?.trim() ?? paragraph;
   return sentence.length > 160 ? `${sentence.slice(0, 157).trimEnd()}\u2026` : sentence;
 }
-function toReadableSummary(filePath, spec) {
+var modifiedAtOf = (deps, filePath) => deps.storage.modifiedAt?.(filePath) ?? Promise.resolve(null);
+function toReadableSummary(filePath, spec, updatedAt) {
   return {
     id: spec.frontmatter.id,
     status: spec.frontmatter.status,
@@ -1353,7 +1362,8 @@ function toReadableSummary(filePath, spec) {
     depends_on: spec.frontmatter.depends_on,
     filePath,
     presentSections: presentSectionsOf(spec.body),
-    intent: intentOf(spec.body)
+    intent: intentOf(spec.body),
+    updatedAt
   };
 }
 async function listSpecFileNames(deps) {
@@ -1369,7 +1379,7 @@ async function listSpecSummaries(deps) {
     const parsed = parseSpec(filePath, fileName, content);
     const id = fileName.replace(/\.spec\.md$/, "");
     summaries.push(
-      parsed.ok ? toReadableSummary(filePath, parsed.spec) : { id, filePath, error: parsed.error }
+      parsed.ok ? toReadableSummary(filePath, parsed.spec, await modifiedAtOf(deps, filePath)) : { id, filePath, error: parsed.error }
     );
   }
   return summaries;
@@ -1484,7 +1494,7 @@ ${serialized}
 ---${body}`;
   const message = isValidation ? `spec: validate ${specId}` : `spec: save ${specId}`;
   await deps.storage.write(filePath, content, message);
-  return toReadableSummary(filePath, { frontmatter: input.frontmatter, body });
+  return toReadableSummary(filePath, { frontmatter: input.frontmatter, body }, await modifiedAtOf(deps, filePath));
 }
 async function createSpec(deps, specId) {
   const fileName = `${specId}.spec.md`;
@@ -1526,7 +1536,7 @@ async function createSpec(deps, specId) {
       suggestedFix: "Fix the template's frontmatter to match SpecFrontmatterSchema."
     });
   }
-  return toReadableSummary(filePath, parsed.spec);
+  return toReadableSummary(filePath, parsed.spec, await modifiedAtOf(deps, filePath));
 }
 async function getManifest(deps) {
   const content = await deps.storage.readFile(MANIFEST_PATH);
@@ -1920,7 +1930,9 @@ var ReadableSpecSummarySchema = z7.object({
   filePath: z7.string(),
   presentSections: z7.array(z7.string()),
   /** The first sentence of `# @intent`, for a list that reads (v1.20: the target-spec suggestions of the brief). */
-  intent: z7.string().default("")
+  intent: z7.string().default(""),
+  /** When the spec last changed (ISO 8601) — the board's order, newest first (v3.4); null when the storage does not know. */
+  updatedAt: z7.string().nullable().default(null)
 });
 var UnreadableSpecSummarySchema = z7.object({
   id: z7.string(),
@@ -3687,6 +3699,12 @@ function createHostedSpecStorage(deps) {
     async readFile(path) {
       return (await readerOf(path)).readFile(path);
     },
+    async modifiedAt(path) {
+      if (deps.lastCommitDateOf === void 0) return null;
+      const specId = specIdOfPath2(path);
+      const ref = specId !== null && (await branches()).has(specBranchOf(specId)) ? specBranchOf(specId) : deps.github.defaultBranch;
+      return deps.lastCommitDateOf(ref, path);
+    },
     async exists(path) {
       return (await readerOf(path)).exists(path);
     },
@@ -4729,6 +4747,15 @@ function createGithubPullsClient(deps) {
       );
       return (json ?? []).map((entry) => ({ sha: entry.sha, message: entry.commit.message }));
     },
+    async lastCommitDateOf(branch, path) {
+      const { json } = await request(
+        "GET",
+        `${repoUrl}/commits?sha=${encodeURIComponent(branch)}&path=${encodeURIComponent(path)}&per_page=1`,
+        void 0
+      );
+      const last = json?.[0];
+      return last?.commit.committer?.date ?? last?.commit.author?.date ?? null;
+    },
     async getPullRequest(number) {
       const { json } = await request(
         "GET",
@@ -5130,6 +5157,7 @@ async function startHostedStudio(options) {
       }
     }
   }
+  const pulls = createGithubPullsClient({ github: config.repo, fetchImpl: githubApp.installationFetch });
   const app = await createStudioApp({
     uiDistDir,
     hosted: {
@@ -5157,7 +5185,7 @@ async function startHostedStudio(options) {
           }
         }
       },
-      pulls: createGithubPullsClient({ github: config.repo, fetchImpl: githubApp.installationFetch }),
+      pulls,
       readerFor,
       usage: createGithubUsageClient({ github: config.repo, fetchImpl: githubApp.installationFetch }),
       ...deploy === void 0 ? {} : { deploy },
@@ -5167,6 +5195,7 @@ async function startHostedStudio(options) {
         github: config.repo,
         readerFor,
         listSpecBranches,
+        lastCommitDateOf: pulls.lastCommitDateOf,
         client,
         user,
         now,