@pareto4/pp-core 1.21.1 → 1.23.1

package/hooks/dist/pp-update-banner.js

@@ -17,6 +17,36 @@ const path = require('path');
 const os = require('os');
 const { PACKAGE_NAME, updateCacheFileName } = require('../pp-core/bin/lib/package-identity.cjs');
 
+// Audience wording (MSG-06, D-18, D-20): the light catalog entry. When it cannot
+// load, the banner prints today's developer text.
+let hookMessages = null;
+try {
+  hookMessages = require('../pp-core/bin/lib/hook-messages.cjs');
+} catch (e) {
+  hookMessages = null;
+}
+
+/** The audience for this process; developer when the catalog is unavailable or throws. */
+function hookAudience() {
+  if (!hookMessages) return 'developer';
+  try {
+    return hookMessages.audienceOf(process.env);
+  } catch (e) {
+    return 'developer';
+  }
+}
+
+/** The catalog message for `code`, or `literal` (today's developer string) on any failure. */
+function hookText(code, params, audience, literal) {
+  if (!hookMessages || audience === 'developer') return literal;
+  try {
+    const out = hookMessages.msg(code, params, audience, literal);
+    return typeof out === 'string' && out !== '' ? out : literal;
+  } catch (e) {
+    return literal;
+  }
+}
+
 // Suppress repeat parse-error banners for 24 hours so a genuinely broken
 // cache file doesn't nag the user every session.
 const RATE_LIMIT_SECONDS = 24 * 60 * 60;
@@ -29,13 +59,18 @@ const RATE_LIMIT_SECONDS = 24 * 60 * 60;
  * @param {object|null} state.cache                  Parsed cache, or null if missing/unreadable.
  * @param {boolean}     state.parseError             True iff cache file existed but JSON.parse failed.
  * @param {boolean}     state.suppressFailureWarning True when a recent failure warning already fired.
+ * @param {object} [opts]
+ * @param {string} [opts.audience='developer']       Whose wording to use; the developer text is today's string.
  * @returns {{systemMessage: string}|null}           JSON envelope, or null for silent exit.
  */
-function buildBannerOutput(state) {
+function buildBannerOutput(state, opts) {
+  const audience = (opts && opts.audience) || 'developer';
   const { cache, parseError, suppressFailureWarning } = state || {};
   if (parseError) {
     if (suppressFailureWarning) return null;
-    return { systemMessage: 'GSD update check failed.' };
+    return {
+      systemMessage: hookText('hook.banner.check_failed', {}, audience, 'pp-core update check failed.'),
+    };
   }
   if (!cache) return null;
   // Lineage guard: package_name must be present and match this package.
@@ -45,7 +80,12 @@ function buildBannerOutput(state) {
   const installed = cache.installed || 'unknown';
   const latest = cache.latest || 'unknown';
   return {
-    systemMessage: `GSD update available: ${installed} → ${latest}. Run /gsd:update.`,
+    systemMessage: hookText(
+      'hook.banner.update_available',
+      { installed, latest },
+      audience,
+      `pp-core update available: ${installed} → ${latest}. Run /pp-update.`
+    ),
   };
 }
 
@@ -108,7 +148,7 @@ function main() {
   const suppressFailureWarning = parseError
     ? shouldSuppressFailureWarning(sentinelFile, now)
     : false;
-  const output = buildBannerOutput({ cache, parseError, suppressFailureWarning });
+  const output = buildBannerOutput({ cache, parseError, suppressFailureWarning }, { audience: hookAudience() });
 
   if (parseError && !suppressFailureWarning) {
     // Ensure cache dir exists before writing the sentinel — first-run case

package/hooks/dist/pp-workflow-guard.js

@@ -5,7 +5,7 @@
 // (no active /gsd- skill or Task subagent) and injects an advisory warning.
 //
 // This is a SOFT guard — it advises, not blocks. The edit still proceeds.
-// The warning nudges Claude to use /gsd:quick or /gsd:fast instead of
+// The warning nudges Claude to use /pp-quick or /pp-fast instead of
 // making direct edits that bypass state tracking.
 //
 // Enable via config: hooks.workflow_guard: true (default: false)
@@ -151,9 +151,9 @@ process.stdin.on('end', () => {
     const output = {
       hookSpecificOutput: {
         hookEventName: "PreToolUse",
-        additionalContext: `⚠️ WORKFLOW ADVISORY: You're editing ${path.basename(filePath)} directly without a GSD command. ` +
+        additionalContext: `⚠️ WORKFLOW ADVISORY: You're editing ${path.basename(filePath)} directly without a pp-core command. ` +
           'This edit will not be tracked in STATE.md or produce a SUMMARY.md. ' +
-          'Consider using /gsd:fast for trivial fixes or /gsd:quick for larger changes ' +
+          'Consider using /pp-fast for trivial fixes or /pp-quick for larger changes ' +
           'to maintain project state tracking. ' +
           'If this is intentional (e.g., user explicitly asked for a direct edit), proceed normally.'
       }

package/hooks/pp-check-update-worker.js

@@ -18,7 +18,7 @@ const { isSemverNewer } = require('../pp-core/bin/lib/semver-compare.cjs');
 // The previous `require('../package.json').name` (#378) resolved to undefined
 // in the installed tree (only a {"type":"commonjs"} marker ships), so the
 // background check never reported updates.
-const { checkLatestVersion } = require('../gsd-core/bin/check-latest-version.cjs');
+const { checkLatestVersion } = require('../pp-core/bin/check-latest-version.cjs');
 const { PACKAGE_NAME } = require('../pp-core/bin/lib/package-identity.cjs');
 // Authoritative list of managed hooks — shared with tests to retire source-grep
 // assertions (pending-migration-to-typed-ir [#455]).

package/hooks/pp-context-monitor.js

@@ -133,7 +133,7 @@ process.stdin.on('end', () => {
     const isGsdActive = fs.existsSync(path.join(cwd, '.planning', 'STATE.md'));
 
     // On CRITICAL with active GSD project, auto-record session state as a
-    // breadcrumb for /gsd:resume-work (#1974). Fire-and-forget subprocess —
+    // breadcrumb for /pp-resume-work (#1974). Fire-and-forget subprocess —
     // doesn't block the hook or the agent. Fires ONCE per CRITICAL session,
     // guarded by warnData.criticalRecorded to prevent repeated overwrites
     // of the "crash moment" record on every debounce cycle.
@@ -165,8 +165,8 @@ process.stdin.on('end', () => {
       message = isGsdActive
         ? `CONTEXT CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
           'Context is nearly exhausted. Do NOT start new complex work or write handoff files — ' +
-          'GSD state is already tracked in STATE.md. Inform the user so they can run ' +
-          '/gsd:pause-work at the next natural stopping point.'
+          'pp-core state is already tracked in STATE.md. Inform the user so they can run ' +
+          '/pp-pause-work at the next natural stopping point.'
         : `CONTEXT CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
           'Context is nearly exhausted. Inform the user that context is low and ask how they ' +
           'want to proceed. Do NOT autonomously save state or write handoff files unless the user asks.';

package/hooks/pp-statusline.js

@@ -9,6 +9,59 @@ const os = require('os');
 const { isSemverNewer } = require('../pp-core/bin/lib/semver-compare.cjs');
 const { PACKAGE_NAME, updateCacheFileName } = require('../pp-core/bin/lib/package-identity.cjs');
 
+// --- Audience wording (MSG-06, D-18, D-20) ----------------------------------
+// The light catalog entry. When it cannot load (missing, broken, or its slice
+// missing) every text below stays today's developer string.
+let hookMessages = null;
+try {
+  hookMessages = require('../pp-core/bin/lib/hook-messages.cjs');
+} catch (e) {
+  hookMessages = null;
+}
+
+/** The audience for this process; developer when the catalog is unavailable or throws. */
+function hookAudience() {
+  if (!hookMessages) return 'developer';
+  try {
+    return hookMessages.audienceOf(process.env);
+  } catch (e) {
+    return 'developer';
+  }
+}
+
+/** The catalog text for `code`, or `literal` (today's developer string) on any failure. */
+function hookText(code, params, audience, literal) {
+  if (!hookMessages || audience === 'developer') return literal;
+  try {
+    const out = hookMessages.msg(code, params, audience, literal);
+    return typeof out === 'string' && out !== '' ? out : literal;
+  } catch (e) {
+    return literal;
+  }
+}
+
+/** The display word for a canonical value, or the value itself on any failure. */
+function hookLabel(domain, value, audience) {
+  if (!hookMessages || audience === 'developer') return value;
+  try {
+    const out = hookMessages.label(domain, value, audience);
+    return typeof out === 'string' && out !== '' ? out : value;
+  } catch (e) {
+    return value;
+  }
+}
+
+/** The display text for a STATE.md status, or the status itself on any failure. */
+function hookStatusWord(status, audience) {
+  if (!hookMessages || audience === 'developer') return status;
+  try {
+    const out = hookMessages.statusWord(status, audience);
+    return typeof out === 'string' && out !== '' ? out : status;
+  } catch (e) {
+    return status;
+  }
+}
+
 // --- Config + last-command readers ------------------------------------------
 
 /**
@@ -241,7 +294,8 @@ function renderProgressBar(percent) {
  * Progress bar is opt-in: appended to the milestone segment only when
  * progress.percent is present in frontmatter; absent → empty string.
  */
-function formatGsdState(s) {
+function formatGsdState(s, opts) {
+  const audience = (opts && opts.audience) || 'developer';
   const parts = [];
 
   // Milestone segment: version + name + (opt-in) progress bar
@@ -261,24 +315,41 @@ function formatGsdState(s) {
     // Scene 1: an orchestrator is mid-flight on this phase.
     // stage = whichever lifecycle status was written by the orchestrator
     //   (discussing / planning / executing / verifying)
-    const stage = s.status || '';
-    parts.push(stage ? `Phase ${s.activePhase} ${stage}` : `Phase ${s.activePhase}`);
+    const stage = s.status ? hookStatusWord(s.status, audience) : '';
+    parts.push(stage
+      ? hookText('hook.statusline.phase_stage', { number: s.activePhase, stage }, audience, `Phase ${s.activePhase} ${s.status}`)
+      : hookText('hook.statusline.phase', { number: s.activePhase }, audience, `Phase ${s.activePhase}`));
   } else if (s.nextAction && phasesStr) {
     // Scene 2: idle + a recommended next command is visible to the user.
     // Surfaces "what to run next" without the user opening STATE.md.
-    parts.push(`next ${s.nextAction} ${phasesStr}`);
+    parts.push(hookText(
+      'hook.statusline.next',
+      { action: hookLabel('state.next_action', s.nextAction, audience), numbers: phasesStr },
+      audience,
+      `next ${s.nextAction} ${phasesStr}`
+    ));
   } else if (Number(s.percent) === 100 || (s.completedPhases && s.totalPhases && s.completedPhases === s.totalPhases)) {
     // Scene 3: milestone complete (every phase done).
-    parts.push('milestone complete');
+    parts.push(hookText('hook.statusline.milestone_complete', {}, audience, 'milestone complete'));
   } else {
     // Backward-compatible default — preserved EXACTLY for STATE.md files that
     // don't carry the new lifecycle fields. Identical output to v1.38.x and
     // earlier so no existing project's status-line changes shape.
-    if (s.status) parts.push(s.status);
+    if (s.status) parts.push(hookStatusWord(s.status, audience));
     if (s.phaseNum && s.phaseTotal) {
       const phase = s.phaseName
-        ? `${s.phaseName} (${s.phaseNum}/${s.phaseTotal})`
-        : `ph ${s.phaseNum}/${s.phaseTotal}`;
+        ? hookText(
+          'hook.statusline.phase_named',
+          { name: s.phaseName, num: s.phaseNum, total: s.phaseTotal },
+          audience,
+          `${s.phaseName} (${s.phaseNum}/${s.phaseTotal})`
+        )
+        : hookText(
+          'hook.statusline.phase_count',
+          { num: s.phaseNum, total: s.phaseTotal },
+          audience,
+          `ph ${s.phaseNum}/${s.phaseTotal}`
+        );
       parts.push(phase);
     }
   }
@@ -393,7 +464,9 @@ function runStatusline() {
     }
 
     // GSD state (milestone · status · phase) — shown when no todo task
-    const gsdStateStr = task ? '' : formatGsdState(readGsdState(dir) || {});
+    // The audience is resolved once per run, never inside the formatter (Pitfall 7).
+    const audience = hookAudience();
+    const gsdStateStr = task ? '' : formatGsdState(readGsdState(dir) || {}, { audience });
 
     // GSD update available?
     // Read only the per-package shared cache file (#607). The legacy
@@ -406,12 +479,12 @@ function runStatusline() {
         const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
         const { showUpdate, staleWarning } = evaluateUpdateCache(cache);
         if (showUpdate) {
-          gsdUpdate = '\x1b[33m⬆ /gsd:update\x1b[0m │ ';
+          gsdUpdate = '\x1b[33m' + hookText('hook.statusline.update', {}, audience, '⬆ /pp-update') + '\x1b[0m │ ';
         }
         if (staleWarning === 'dev') {
-          gsdUpdate += '\x1b[33m⚠ dev install — re-run installer to sync hooks\x1b[0m │ ';
+          gsdUpdate += '\x1b[33m' + hookText('hook.statusline.dev_install', {}, audience, '⚠ dev install — re-run installer to sync hooks') + '\x1b[0m │ ';
         } else if (staleWarning === 'stale') {
-          gsdUpdate += '\x1b[31m⚠ stale hooks — run /gsd:update\x1b[0m │ ';
+          gsdUpdate += '\x1b[31m' + hookText('hook.statusline.stale', {}, audience, '⚠ stale hooks — run /pp-update') + '\x1b[0m │ ';
         }
       } catch (e) {}
     }
@@ -556,7 +629,8 @@ module.exports = {
  * Render the statusline from an already-parsed hook input object. Exported for
  * testing without feeding stdin. Returns the rendered string.
  */
-function renderStatusline(data) {
+function renderStatusline(data, opts) {
+  const audience = (opts && opts.audience) || hookAudience();
   const model = data.model?.display_name || 'Claude';
   const dir = data.workspace?.current_dir || process.cwd();
   const dirname = path.basename(dir);
@@ -575,7 +649,7 @@ function renderStatusline(data) {
     if (cfgPos != null) position = cfgPos;
   } catch (e) { /* swallow */ }
 
-  const gsdStateStr = formatGsdState(readGsdState(dir) || {});
+  const gsdStateStr = formatGsdState(readGsdState(dir) || {}, { audience });
   const middle = gsdStateStr ? `\x1b[2m${gsdStateStr}\x1b[0m` : null;
   return formatDevBadge(readDevBuild()) + composeStatusline({ model, ctx: '', middle, dirname, lastCmdSuffix, position });
 }

package/hooks/pp-update-banner.js

@@ -17,6 +17,36 @@ const path = require('path');
 const os = require('os');
 const { PACKAGE_NAME, updateCacheFileName } = require('../pp-core/bin/lib/package-identity.cjs');
 
+// Audience wording (MSG-06, D-18, D-20): the light catalog entry. When it cannot
+// load, the banner prints today's developer text.
+let hookMessages = null;
+try {
+  hookMessages = require('../pp-core/bin/lib/hook-messages.cjs');
+} catch (e) {
+  hookMessages = null;
+}
+
+/** The audience for this process; developer when the catalog is unavailable or throws. */
+function hookAudience() {
+  if (!hookMessages) return 'developer';
+  try {
+    return hookMessages.audienceOf(process.env);
+  } catch (e) {
+    return 'developer';
+  }
+}
+
+/** The catalog message for `code`, or `literal` (today's developer string) on any failure. */
+function hookText(code, params, audience, literal) {
+  if (!hookMessages || audience === 'developer') return literal;
+  try {
+    const out = hookMessages.msg(code, params, audience, literal);
+    return typeof out === 'string' && out !== '' ? out : literal;
+  } catch (e) {
+    return literal;
+  }
+}
+
 // Suppress repeat parse-error banners for 24 hours so a genuinely broken
 // cache file doesn't nag the user every session.
 const RATE_LIMIT_SECONDS = 24 * 60 * 60;
@@ -29,13 +59,18 @@ const RATE_LIMIT_SECONDS = 24 * 60 * 60;
  * @param {object|null} state.cache                  Parsed cache, or null if missing/unreadable.
  * @param {boolean}     state.parseError             True iff cache file existed but JSON.parse failed.
  * @param {boolean}     state.suppressFailureWarning True when a recent failure warning already fired.
+ * @param {object} [opts]
+ * @param {string} [opts.audience='developer']       Whose wording to use; the developer text is today's string.
  * @returns {{systemMessage: string}|null}           JSON envelope, or null for silent exit.
  */
-function buildBannerOutput(state) {
+function buildBannerOutput(state, opts) {
+  const audience = (opts && opts.audience) || 'developer';
   const { cache, parseError, suppressFailureWarning } = state || {};
   if (parseError) {
     if (suppressFailureWarning) return null;
-    return { systemMessage: 'GSD update check failed.' };
+    return {
+      systemMessage: hookText('hook.banner.check_failed', {}, audience, 'pp-core update check failed.'),
+    };
   }
   if (!cache) return null;
   // Lineage guard: package_name must be present and match this package.
@@ -45,7 +80,12 @@ function buildBannerOutput(state) {
   const installed = cache.installed || 'unknown';
   const latest = cache.latest || 'unknown';
   return {
-    systemMessage: `GSD update available: ${installed} → ${latest}. Run /gsd:update.`,
+    systemMessage: hookText(
+      'hook.banner.update_available',
+      { installed, latest },
+      audience,
+      `pp-core update available: ${installed} → ${latest}. Run /pp-update.`
+    ),
   };
 }
 
@@ -108,7 +148,7 @@ function main() {
   const suppressFailureWarning = parseError
     ? shouldSuppressFailureWarning(sentinelFile, now)
     : false;
-  const output = buildBannerOutput({ cache, parseError, suppressFailureWarning });
+  const output = buildBannerOutput({ cache, parseError, suppressFailureWarning }, { audience: hookAudience() });
 
   if (parseError && !suppressFailureWarning) {
     // Ensure cache dir exists before writing the sentinel — first-run case

package/hooks/pp-workflow-guard.js

@@ -5,7 +5,7 @@
 // (no active /gsd- skill or Task subagent) and injects an advisory warning.
 //
 // This is a SOFT guard — it advises, not blocks. The edit still proceeds.
-// The warning nudges Claude to use /gsd:quick or /gsd:fast instead of
+// The warning nudges Claude to use /pp-quick or /pp-fast instead of
 // making direct edits that bypass state tracking.
 //
 // Enable via config: hooks.workflow_guard: true (default: false)
@@ -151,9 +151,9 @@ process.stdin.on('end', () => {
     const output = {
       hookSpecificOutput: {
         hookEventName: "PreToolUse",
-        additionalContext: `⚠️ WORKFLOW ADVISORY: You're editing ${path.basename(filePath)} directly without a GSD command. ` +
+        additionalContext: `⚠️ WORKFLOW ADVISORY: You're editing ${path.basename(filePath)} directly without a pp-core command. ` +
           'This edit will not be tracked in STATE.md or produce a SUMMARY.md. ' +
-          'Consider using /gsd:fast for trivial fixes or /gsd:quick for larger changes ' +
+          'Consider using /pp-fast for trivial fixes or /pp-quick for larger changes ' +
           'to maintain project state tracking. ' +
           'If this is intentional (e.g., user explicitly asked for a direct edit), proceed normally.'
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pareto4/pp-core",
-  "version": "1.21.1",
+  "version": "1.23.1",
   "description": "Pareto pp-core — The Pareto Project's AI-assisted engineering framework: meta-prompting, context engineering, and spec-driven development for AI coding agents.",
   "bin": {
     "pp-core": "bin/install.js",
@@ -71,7 +71,7 @@
   },
   "overrides": {
     "qs": ">=6.16.0",
-    "@hono/node-server": ">=2.0.5",
+    "@hono/node-server": ">=2.1.3",
     "body-parser": "^2.4.0",
     "fast-uri": "^3.1.9",
     "zod": "^4.6.6"