create-substrat 0.6.1 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-substrat",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Scaffold a Substrat vertical — `npm create substrat <dir>`.",
   "license": "Apache-2.0",
   "repository": {

package/template/.substrat/hooks/session-start.mjs

@@ -19,8 +19,13 @@
  * This file lives in `.substrat/` — the tool-neutral home, next to `playbook.md` —
  * not in `.claude/`. `.claude/settings.json` is a three-line adapter that runs it,
  * and any other client that grows a session hook binds the same way. It also
- * means the plugin distribution (#753) can ship this script unchanged rather than
- * forking it.
+ * means the plugin distribution (#753) ships this script unchanged rather than
+ * forking it: `plugin/substrat/scripts/session-start.mjs` is emitted from this
+ * file byte-for-byte, and `pnpm lint:plugin --check` fails if the two diverge.
+ *
+ * The plugin copy is what reaches a project scaffolded before this hook existed.
+ * When a project owns its own copy, the plugin's stays silent — see
+ * `isPluginCopy()` below — so a scaffolded project announces itself once.
  *
  * ## Deliberately silent, and deliberately offline
  *
@@ -33,8 +38,9 @@
  *
  * Opt out by creating `.substrat/no-session-context`.
  */
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { existsSync, readFileSync, realpathSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname, join, relative, isAbsolute } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const DOCS = 'https://substrat.net';
 const KERNEL = '@substrat-run/kernel';
@@ -42,6 +48,33 @@ const KERNEL = '@substrat-run/kernel';
 /** Where the project is. Claude Code sets this; fall back to the cwd it ran us in. */
 const root = process.env.CLAUDE_PROJECT_DIR || process.cwd();
 
+/** Where this script is. The two copies differ only in where they sit on disk. */
+const self = fileURLToPath(import.meta.url);
+
+/** Symlinks resolved, so a project reached through one is not mistaken for elsewhere. */
+function real(path) {
+  try {
+    return realpathSync(path);
+  } catch {
+    return path;
+  }
+}
+
+/**
+ * True when we are the plugin's copy rather than the project's own.
+ *
+ * Asked positionally instead of by a flag, because the two copies must stay
+ * byte-identical for `lint:plugin` to have anything to check: a copy that is
+ * invoked differently is a copy that can be edited differently. Both sides are
+ * resolved first — on macOS a project under `/tmp` is handed to us as
+ * `/private/tmp`, and an unresolved compare would read the project's own copy as
+ * foreign and silence the very hook that should speak.
+ */
+function isPluginCopy() {
+  const inside = relative(real(root), real(self));
+  return inside.startsWith('..') || isAbsolute(inside);
+}
+
 /** The marker: which kernel version this project last announced. */
 const MARKER = join(root, '.substrat', '.docs-pin');
 const OPT_OUT = join(root, '.substrat', 'no-session-context');
@@ -67,6 +100,11 @@ function main() {
   // file to invent, and nothing to keep in sync.
   if (!pkg?.substrat) silent();
 
+  // The project's own copy wins. It ships beside the playbook it points at, so it
+  // is the one that matches what is actually checked out here; the plugin's exists
+  // for projects scaffolded before this hook did, and must not double-announce.
+  if (isPluginCopy() && existsSync(join(root, '.substrat', 'hooks', 'session-start.mjs'))) silent();
+
   if (existsSync(OPT_OUT)) silent();
 
   // What is actually installed beats what package.json asked for: a caret range on