@nightlab-agent/date-check 0.1.2 → 0.1.3

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
       "name": "date-check",
       "source": "./",
       "description": "Checks the dates and times Claude Code writes into files against the real clock before the write lands.",
-      "version": "0.1.2",
+      "version": "0.1.3",
       "category": "productivity"
     }
   ],

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "date-check",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Checks the dates and times Claude Code writes into changelogs, logs, release notes and handoffs against the real clock before the write lands: a stamp in the future is refused with the real time, a stale one gets a note.",
   "homepage": "https://github.com/nightlab-agent/date-check#readme",
   "repository": "https://github.com/nightlab-agent/date-check",
@@ -31,7 +31,7 @@
     "staleDays": {
       "type": "number",
       "title": "Days behind before a note",
-      "description": "A written date more than this many days before today gets a note.",
+      "description": "A written date more than this many days before today gets a note; a new file named for such a day is refused once.",
       "default": 1
     },
     "staleNotes": {

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.1.3 (2026-11-01)
+
+- A new Markdown or text file whose name carries a date more than a day before today
+  (`briefs/daily-brief-2025-06-12.md` created on 2026-11-01) is refused once, with the real
+  date. If that date is meant (a record of that day), Claude writes the same file again and it
+  goes through. A name with today's date, yesterday's or a later day's (a plan) is not judged,
+  nor a file that already exists, nor a date in a folder's name. The days allowed follow the
+  "days behind" setting. Before, only the stamps inside a file were checked, never its name.
+
 ## 0.1.2 (2026-11-01)
 
 - These zone names after a time are now read: UTC, GMT, EST, EDT, CST, CDT, MST, MDT, PST, PDT,

package/README.md

@@ -17,9 +17,16 @@ Seen in a Claude Code 2.1.312 terminal (120 columns) on 2026-10-31 at 16:52.
 Asked to add a log line starting with 23:40, Claude's first write was refused
 with the real time. Because the request had named 23:40, Claude wrote the same
 line again, it went through, and Claude told the person it was later than now.
-The same happened with a changelog entry dated 2026-11-03. A stamp Claude
-guesses on its own, and the note on an old stamp, have not yet been seen on a
-screen.
+The same happened with a changelog entry dated 2026-11-03.
+
+![Claude Code wrote a log line stamped 00:40 at 02:11; date-check's note on the old stamp gave Claude the real time, and Claude used 02:11 for a line it had held back](https://raw.githubusercontent.com/nightlab-agent/date-check/4901a65a423dbfc9d61aad0b444deb5a445e774d/docs/preview-note.png)
+
+Seen on 2026-11-01 at 02:11 EST, same terminal. Asked to start a log line with
+the current time and not to run commands, Claude did not guess: it asked for
+the time. Then asked to add `- 00:40 backup started`, it wrote that line; the
+note on the old stamp gave it the real time, and it wrote the line it had held
+back as `- 02:11 release went out`. A stamp Claude guesses on its own has not
+yet been seen on a screen.
 
 - A stamp more than 2 minutes in the future is refused, and the refusal tells
   Claude the real date and time. If the future date is meant (a deadline, a
@@ -27,6 +34,11 @@ screen.
 - A time more than 30 minutes old today, or a date more than a day old, goes
   through with a note to Claude: fine for a record of the past, a fix for one
   meant as now.
+- A new Markdown or text file named for a day more than a day before today
+  (`briefs/daily-brief-2025-06-12.md`, created on 2026-11-01) is refused once
+  with the real date. If the date is meant, Claude writes the same file again
+  and it goes through. Today, yesterday and later days (a plan) are not judged,
+  nor files that already exist, nor dates in folder names.
 - What counts as a stamp: a date in a Markdown heading (`## 0.2.0 (2026-11-03)`),
   a labelled field that starts its line (`Date:`, `Updated:`, `Released:`,
   `date:` in frontmatter), or a date or date and time at the start of a line. A
@@ -64,6 +76,14 @@ the night New York's clocks went back. Asked to add the line
 its offset, and Claude asked whether the deploy had finished at 01:58 EDT, an
 hour earlier.
 
+![Claude Code's write of briefs/daily-brief-2025-06-12.md refused by date-check with the real date; Claude wrote it again because the name was given, then said the date was likely wrong and offered today's name](https://raw.githubusercontent.com/nightlab-agent/date-check/e008e44b11e50b3115766b19c489e199b7f94ed1/docs/preview-name.png)
+
+Seen in the same terminal on 2026-11-01 at 02:23 EST. Asked to create today's
+brief as `briefs/daily-brief-2025-06-12.md`, Claude's first write was refused
+with the real date. Because the request had named the file, Claude wrote it
+again, it went through, and Claude told the person the date was more than a
+year old and offered to rename it to `daily-brief-2026-11-01.md`.
+
 ## What it writes
 
 Nothing. It reads the file a Write or an Edit is about to change, to judge only the new

package/hooks/register.tsx

@@ -1,5 +1,5 @@
 import type { EngineInterface, Register } from 'claude-code'
-import { dateOfFile, dayOf, judge, LIMITS, newStamps } from './stamps'
+import { dateOfFile, dayOf, judge, judgeName, LIMITS, newStamps } from './stamps'
 import type { Limits, Verdict } from './stamps'
 
 // date-check, the hooks module. Before a Write, an Edit, or a shell command that appends to
@@ -9,6 +9,8 @@ import type { Limits, Verdict } from './stamps'
 //   the same line written to the same file a second time goes through (a deadline or a plan
 //   can be in the future on purpose), with a note;
 // - a stamp older than the limits goes through with a note the agent reads after the result.
+// - a new file whose name carries a day more than staleDays past (logs/2025-06-12.md written
+//   on 2026-11-01) is refused once with the real date, the same way; a later day is a plan.
 // Lines the file already had are never judged: only what this call adds. Only Markdown and
 // text files (isText): a date in code is data, not a stamp.
 
@@ -52,11 +54,12 @@ export const shellWrite = (command: string): { file: string; text: string } | un
 }
 
 /** What a call changes in which file: the file's text before and after it. */
-async function change($: EngineInterface, x: Call): Promise<{ file: string; before: string; after: string }> {
+async function change($: EngineInterface, x: Call): Promise<{ file: string; before: string; after: string; created?: boolean }> {
   const none = { file: '', before: '', after: '' }
   if (x.tool === 'Write' && typeof x.content === 'string' && x.file_path) {
-    const before = (await $.fs.exists(x.file_path)) ? await $.fs.read(x.file_path) : ''
-    return { file: x.file_path, before, after: x.content }
+    const exists = await $.fs.exists(x.file_path)
+    const before = exists ? await $.fs.read(x.file_path) : ''
+    return { file: x.file_path, before, after: x.content, created: !exists }
   }
   if (x.tool === 'Edit' && typeof x.new_string === 'string' && typeof x.old_string === 'string' && x.file_path) {
     const before = (await $.fs.exists(x.file_path)) ? await $.fs.read(x.file_path) : ''
@@ -69,7 +72,11 @@ async function change($: EngineInterface, x: Call): Promise<{ file: string; befo
   }
   if (x.tool === 'Bash' && typeof x.command === 'string') {
     const w = shellWrite(x.command)
-    return w ? { file: w.file, before: '', after: w.text } : none
+    if (!w) return none
+    // Whether the shell's file is new is only known when its path means one place: not under
+    // `~` (the engine does not expand it) and not after a `cd` in the same command.
+    const sure = !w.file.startsWith('~') && !/(?:^|[;&|\n]\s*)(?:cd|pushd)\s/.test(x.command)
+    return { file: w.file, before: '', after: w.text, created: sure && !(await $.fs.exists(w.file)) }
   }
   return none
 }
@@ -81,6 +88,11 @@ export const refusal = (vs: Verdict[]) =>
   `It is ${vs[0]!.real} now. Write the real date and time, or leave the stamp out. ` +
   `If a future date is meant (a deadline, a planned release), write the same text again and it goes through.`
 
+export const nameRefusal = (file: string, n: { date: string; real: string }) =>
+  `date-check: the new file's name says ${n.date} (${file.split(/[/\\]/).pop()}), a day that has passed. ` +
+  `It is ${n.real} now. If the file is for today, name it for today. ` +
+  `If that date is meant (a record of that day), write the same file again and it goes through.`
+
 export const staleNote = (vs: Verdict[]) =>
   `date-check: ${vs.map(quote).join('; ')} ${vs.length === 1 ? 'is' : 'are'} older than now (${vs[0]!.real}). ` +
   `If ${vs.length === 1 ? 'it records' : 'they record'} something past, leave ${vs.length === 1 ? 'it' : 'them'}; if ${vs.length === 1 ? 'it was' : 'they were'} meant as now, correct ${vs.length === 1 ? 'it' : 'them'}.`
@@ -103,11 +115,13 @@ export const register: Register = (on, options: Options = {}) => {
     if (x.tool !== 'Write' && x.tool !== 'Edit' && x.tool !== 'Bash') return next(e)
     const began = ++order
     let verdicts: Verdict[] = []
+    let name: ReturnType<typeof judgeName>
     let file = ''
     try {
       const now = await $.clock.now()
       const w = await change($, x)
       file = w.file
+      if (file && isText(file) && w.created) name = judgeName(file, now, limits)
       if (file && isText(file) && w.after) {
         // Bare times in a file named for a later day are a plan for that day, not stamps.
         const day = dateOfFile(file)
@@ -116,17 +130,25 @@ export const register: Register = (on, options: Options = {}) => {
     } catch {
       // A failure of this mod never stops the call.
       verdicts = []
+      name = undefined
     }
     const key = (v: Verdict) => `${file}\n${v.stamp.line}`
     const future = verdicts.filter(v => v.kind === 'future')
     const fresh = future.filter(v => !((meant.get(key(v)) ?? Infinity) < began))
-    if (fresh.length) {
-      for (const v of fresh) meant.set(key(v), ++order)
-      return { deny: refusal(fresh) }
+    // By the file's name alone, so a retry spelled another way (relative, absolute) is the same file.
+    const nameKey = `(name)\n${file.split(/[/\\]/).pop()}`
+    const freshName = name && !((meant.get(nameKey) ?? Infinity) < began) ? name : undefined
+    if (fresh.length || freshName) {
+      // The first refusal's number is kept: an older call refused late must not move it past a retry.
+      const mark = (k: string) => { const n = ++order; meant.set(k, Math.min(meant.get(k) ?? Infinity, n)) }
+      for (const v of fresh) mark(key(v))
+      if (freshName) mark(nameKey)
+      return { deny: [...(freshName ? [nameRefusal(file, freshName)] : []), ...(fresh.length ? [refusal(fresh)] : [])].join('\n') }
     }
     const done = await next(e)
     if (done.deny !== undefined || done.isError) return done
     const said = [
+      ...(name ? [`date-check: kept the date ${name.date} in the new file's name as written the second time.`] : []),
       ...(future.length ? [`date-check: kept ${future.map(v => `"${v.stamp.text}"`).join(', ')} as written the second time (a date in the future on purpose).`] : []),
       ...(notes && verdicts.some(v => v.kind === 'stale') ? [staleNote(verdicts.filter(v => v.kind === 'stale'))] : []),
     ]

package/hooks/stamps.ts

@@ -224,3 +224,16 @@ export const judge = (stamps: Stamp[], now: number, limits: Limits = LIMITS, zon
   }
   return out
 }
+
+/**
+ * The date in a new file's name, when it is more than `staleDays` before today: the agent
+ * named the file for the day it guessed, often one near its training. A later day is a plan
+ * (an agenda for 2026-11-05), not judged. `undefined` when the name carries no date or the
+ * date can be today.
+ */
+export const judgeName = (path: string, now: number, limits: Limits = LIMITS): { date: string; real: string } | undefined => {
+  const date = dateOfFile(path)
+  if (!date) return undefined
+  const v = judge([{ text: date, line: path, where: 'field', date }], now, limits)[0]
+  return v?.kind === 'stale' ? { date, real: v.real } : undefined
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightlab-agent/date-check",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Claude Code mod: checks the dates and times Claude Code writes into changelogs, logs, release notes and handoffs against the real clock before the write lands; a stamp in the future is refused with the real time.",
   "keywords": [
     "claude-code",