projectstore-claude 0.29.2 → 0.29.4

package/node_modules/projectstore/hooks/session-rules.mjs

@@ -25,11 +25,13 @@ import { readConfig, readStdinJson, adoptHookInput, roleForm, sharedRoleForm } f
 // told once that both name one role — otherwise the second rule below would
 // have it report the block as a contradiction every session.
 function rules() {
-  const critic = roleForm("critic"), reviewer = roleForm("reviewer");
+  const critic = roleForm("critic"),
+    reviewer = roleForm("reviewer");
   const shared = sharedRoleForm("critic");
-  const bridge = shared === critic
-    ? ""
-    : `\n\nThe \`AGENTS.md\` block may name roles as \`${shared}\`; that is the same role, called \`${critic}\` here.`;
+  const bridge =
+    shared === critic
+      ? ""
+      : `\n\nThe \`AGENTS.md\` block may name roles as \`${shared}\`; that is the same role, called \`${critic}\` here.`;
   return `# projectstore — standing rules for this session
 
 **Artifact-first order.** A feature-sized request opens a vault artifact before
@@ -46,9 +48,11 @@ contradiction becomes invisible to the person who could have settled it.${bridge
 }
 
 function emit(additionalContext) {
-  process.stdout.write(JSON.stringify({
-    hookSpecificOutput: { hookEventName: "SessionStart", additionalContext },
-  }) + "\n");
+  process.stdout.write(
+    JSON.stringify({
+      hookSpecificOutput: { hookEventName: "SessionStart", additionalContext },
+    }) + "\n",
+  );
 }
 
 function main() {
@@ -70,6 +74,8 @@ function main() {
   emit(rules());
 }
 
-try { main(); } catch {
+try {
+  main();
+} catch {
   // A hook must never break session startup.
 }

package/node_modules/projectstore/hooks/session-start.mjs

@@ -13,7 +13,7 @@
 //    open. Bounded and O(1) in vault size by construction.
 
 import { existsSync, writeFileSync, mkdirSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { dirname } from "node:path";
 import {
   readConfig,
   gatherVaultFacts,
@@ -27,9 +27,10 @@ import {
   layoutPaths,
   pickExisting,
   activeHarnessId,
-  ensureRuntimeDir,
+  ensureStateRoot,
   syncStatusLine,
   cleanupStaleSessionState,
+  refreshStoryPointer,
   armReminder,
   truncEnd,
   truncFront,
@@ -64,9 +65,10 @@ function welcomedMarkerWritePath(proj) {
 // the one instruction it carries branches on the binding; everything else is
 // the same message.
 function buildWelcome(cfg = null) {
-  const start = cfg && cfg.vault_path
-    ? `**Already bound**: this project's vault is \`${truncFront(String(cfg.vault_path), PATH_CELL)}\`. Ask for what you want — the agent picks up commands like \`${commandForm("adr")}\` and \`${commandForm("epic")}\` from the conversation, and you approve every write. If the vault has no folders yet, \`${commandForm("scaffold")}\` lays them out.`
-    : `**To start using it**: run \`${commandForm("bind", { args: "<vault-path>" })}\` and point it at an Obsidian vault (or any folder). After that, the agent will pick up commands like \`${commandForm("adr")}\` and \`${commandForm("epic")}\` from the conversation; you only approve the writes.`;
+  const start =
+    cfg && cfg.vault_path
+      ? `**Already bound**: this project's vault is \`${truncFront(String(cfg.vault_path), PATH_CELL)}\`. Ask for what you want — the agent picks up commands like \`${commandForm("adr")}\` and \`${commandForm("epic")}\` from the conversation, and you approve every write. If the vault has no folders yet, \`${commandForm("scaffold")}\` lays them out.`
+      : `**To start using it**: run \`${commandForm("bind", { args: "<vault-path>" })}\` and point it at an Obsidian vault (or any folder). After that, the agent will pick up commands like \`${commandForm("adr")}\` and \`${commandForm("epic")}\` from the conversation; you only approve the writes.`;
   return [
     "# 👋 projectstore is loaded for the first time in this project",
     "",
@@ -90,7 +92,11 @@ function showWelcomeOnce(proj, cfg = null) {
   const text = buildWelcome(cfg);
   try {
     const marker = welcomedMarkerWritePath(proj);
-    ensureRuntimeDir(proj); // .projectstore/.gitignore ignores state/; the marker is not a session file
+    // The state directory's own .gitignore, header included, even in an
+    // unbound project — and no sessions/ there: it is how a project uninstall
+    // recognises this marker as ours (install spec contract 13, as amended by
+    // the shell-fetch story).
+    ensureStateRoot(proj);
     mkdirSync(dirname(marker), { recursive: true });
     writeFileSync(marker, new Date().toISOString() + "\n", "utf8");
   } catch {}
@@ -174,15 +180,25 @@ async function main() {
   // an unbound one that is not a worktree pays a single ~10 ms probe.
   let binding = null;
   if (!cfg) {
-    try { binding = resolveBinding(proj); } catch {}
+    try {
+      binding = resolveBinding(proj);
+    } catch {}
   }
   const welcome = showWelcomeOnce(proj, cfg);
   // The person's channel carries one instruction, and it has to be the right
-  // one: a bound project is told what it is bound to, not to bind again.
+  // one: a bound project is told what it is bound to, not to bind again. A
+  // command stands alone on its line, the update hint on lines of its own
+  // after it (the story "User-facing text says where to run…", rules 4 and 5).
   const welcomeSystemMessage = welcome
-    ? (cfg && cfg.vault_path
+    ? cfg && cfg.vault_path
       ? `👋 projectstore: first-run welcome shown. Bound to ${cfg.vault_path}. ${updateHint().line}`
-      : `👋 projectstore: first-run welcome shown. Start with ${commandForm("bind", { args: "<vault-path>" })}. ${updateHint().line}`)
+      : [
+          "👋 projectstore: first-run welcome shown. Start with:",
+          commandForm("bind", { args: "<vault-path>" }),
+          updateHint().line,
+        ]
+          .filter(Boolean)
+          .join("\n")
     : null;
 
   if (!cfg) {
@@ -192,8 +208,10 @@ async function main() {
     // whose parent is already bound. Ordering is the cheap fix; the small
     // redundancy is accepted rather than papered over with copy that will rot.
     const offer = binding && binding.state === "inheritable" ? bindingOfferText(binding) : "";
+    // What binding does first, then the command alone on its line: an
+    // in-session form that can carry the parent's vault path (rule 4).
     const offerSystemMessage = offer
-      ? `projectstore: this worktree is unbound — ${inheritForm(binding.vaultPath, { layout: binding.layout, language: binding.language })} ${bindInherits() ? "adopts the binding of" : "binds it to the vault, layout and language of"} the checkout it was forked from.`
+      ? `projectstore: this worktree is unbound. ${bindInherits() ? "Adopt the binding of" : "Bind it to the vault, layout and language of"} the checkout it was forked from, in the session:\n${inheritForm(binding.vaultPath, { layout: binding.layout, language: binding.language })}`
       : null;
     const body = offer + (welcome || "");
     if (body) {
@@ -209,10 +227,23 @@ async function main() {
   // Opt-in status line: keep settings.local.json pointed at this plugin
   // version's statusline.mjs (self-heals on update). Best-effort; a settings
   // write must never break session-context injection.
-  try { syncStatusLine(cfg, proj); } catch {}
+  try {
+    syncStatusLine(cfg, proj);
+  } catch {}
   // Statusline-feature housekeeping, like syncStatusLine — must run even when
   // auto_inject=false (touch-session writes pointers regardless of it).
-  try { cleanupStaleSessionState(proj); } catch {}
+  try {
+    cleanupStaleSessionState(proj);
+  } catch {}
+  // This session's story fields from the story file, once (ADR-006, amended
+  // 2026-10-12): a pointer written before a close, or a story closed elsewhere
+  // since, stops naming finished work. A bounded read; a lost race writes
+  // nothing.
+  if (sid) {
+    try {
+      await refreshStoryPointer(proj, cfg.vault_path, sid);
+    } catch {}
+  }
 
   // Arm BEFORE the auto_inject gate. The entry reminder's markers must be
   // re-armed after a compaction whether or not this session injects context —
@@ -227,7 +258,9 @@ async function main() {
   // context while its marker persists on disk. Arming lets it fire once more;
   // the cap of two is enforced by the election, not here.
   if (sid && (input?.source === "compact" || input?.source === "clear")) {
-    try { armReminder(proj, sid); } catch {}
+    try {
+      armReminder(proj, sid);
+    } catch {}
   }
 
   if (cfg.auto_inject === false) {
@@ -268,23 +301,26 @@ async function main() {
     }
   }
 
-  // Cheap install-only doctor subset (ADR-005): one line, only when N > 0;
-  // aborted past its budget rather than reporting a false "clean".
+  // Cheap install-only doctor subset (ADR-005): one part, only when N > 0;
+  // aborted past its budget rather than reporting a false "clean". Its doctor
+  // form stands alone on its line, as every command of this line does.
   let doctorMsg = null;
   let offers = [];
   try {
     const r = runStartupChecks(cfg, proj);
     if (r.skipped) {
-      doctorMsg = `projectstore doctor: startup checks skipped — run ${commandForm("doctor")}`;
+      doctorMsg = `projectstore doctor: startup checks skipped. Run them in the session:\n${commandForm("doctor")}`;
     } else if (r.count > 0) {
-      doctorMsg = `projectstore doctor: ${r.count} install issue(s) — run ${commandForm("doctor")}`;
+      doctorMsg = `projectstore doctor: ${r.count} install issue(s). See them in the session:\n${commandForm("doctor")}`;
     }
     // Offers (doctor's OFFER_CHECKS): one-time steps a user should see once,
     // e.g. the re-stamp after a plugin update — not issues, not silent.
     offers = (r.offers || []).map((m) => `projectstore: ${m}`);
   } catch {}
-  const systemMessage =
-    [welcomeSystemMessage, doctorMsg, ...offers].filter(Boolean).join(" · ") || null;
+  // Each part on lines of its own: an offer ends with its command alone on
+  // its line, and a part joined after it with ` · ` would put text after the
+  // command (the story "User-facing text says where to run…", rule 4).
+  const systemMessage = [welcomeSystemMessage, doctorMsg, ...offers].filter(Boolean).join("\n") || null;
 
   if (gatherError) {
     emit(

package/node_modules/projectstore/hooks/session-stop.mjs

@@ -71,12 +71,14 @@ async function main() {
 
   if (!electEmitter(proj, sid)) return;
   appendEntryLog(proj, { at: new Date().toISOString(), session_id: sid, score, via: "Stop" });
-  process.stdout.write(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: "Stop",
-      additionalContext: entryReminderText(score),
-    },
-  }) + "\n");
+  process.stdout.write(
+    JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "Stop",
+        additionalContext: entryReminderText(score),
+      },
+    }) + "\n",
+  );
 }
 
 main().catch(() => {

package/node_modules/projectstore/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectstore",
-  "version": "0.29.2",
+  "version": "0.29.4",
   "description": "Your agent runs the project through a verified loop: task → artifact (ADR / spec / epic / story) → adversarial critic → backlog → planner → reviewer → done. Plain markdown in git — any model can pick the project up tomorrow.",
   "keywords": [
     "project-management",
@@ -41,6 +41,7 @@
   "files": [
     "bin/",
     ".claude-plugin/",
+    "!.claude-plugin/types/",
     "agents/",
     "commands/",
     "harnesses/",
@@ -65,6 +66,15 @@
     "shells": "node packaging/shells.mjs --write",
     "shells:check": "node packaging/shells.mjs --check",
     "shells:build": "node packaging/shells.mjs --build --out dist",
-    "release:check": "npm run adapters:check && npm run guard && npm run shells:check && npm test && npm pack --dry-run"
+    "release:check": "npm run adapters:check && npm run guard && npm run shells:check && npm run lint && npm run format:check && npm test && npm pack --dry-run",
+    "lint": "eslint --max-warnings 0 bin scripts \"hooks/*.mjs\" \"packaging/**/*.mjs\" \"tests/**/*.mjs\" eslint.config.mjs",
+    "format": "prettier --write bin scripts \"hooks/*.mjs\" \"packaging/**/*.mjs\" \"tests/**/*.mjs\" eslint.config.mjs",
+    "format:check": "prettier --check bin scripts \"hooks/*.mjs\" \"packaging/**/*.mjs\" \"tests/**/*.mjs\" eslint.config.mjs"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "eslint": "10.12.0",
+    "eslint-plugin-n": "18.4.1",
+    "prettier": "3.9.10"
   }
 }

package/node_modules/projectstore/scaffold/headings.json

@@ -1,6 +1,14 @@
 {
   "_description": "Language-independent registry of section headings, inline keywords and index-table column names recognized by the deterministic scripts (doctor, reconcile, story-section). Per id, per language: an ARRAY of accepted forms; the FIRST form of the bound language is the canonical form used when writing. Matching accepts every form of every language, so a ru-headed file lints in an en-bound vault. New sections/keywords added by any story MUST register a form for every bundled language (en, ru, es, de, fr, zh) here (PS-SPEC story-002).",
   "headings": {
+    "goal": {
+      "en": ["Goal"],
+      "ru": ["Цель"],
+      "es": ["Objetivo"],
+      "de": ["Ziel"],
+      "fr": ["Objectif"],
+      "zh": ["目标"]
+    },
     "description": {
       "en": ["Description"],
       "ru": ["Описание"],