forge-workflow 0.1.0-beta.5 → 0.1.0-beta.7

package/lib/hook-renderer.js

@@ -83,6 +83,7 @@ const FORGE_SHEPHERD_EVENTS_MARKER = 'hooks shepherd-events';
 // The memory-recall context hook (UserPromptSubmit tier). Its own idempotency marker so a
 // re-render recognizes and REPLACES the Forge-owned entry in place rather than duplicating it.
 const FORGE_MEMORY_RECALL_MARKER = 'hooks memory-recall';
+const FORGE_READ_ATTENTION_MARKER = 'hooks read-attention';
 // The capture-on-exit context hook (PreCompact + Stop tier). A THIRD context marker so a
 // re-merge recognizes + replaces the Forge-owned PreCompact/Stop entries in place. Both
 // events share this one marker (they differ only by a --trigger suffix on the command).
@@ -134,6 +135,13 @@ const USER_PROMPT_SUBMIT_SUPPORT = Object.freeze({
   hermes: Object.freeze({ rendered: false, reason: 'global-config' }),
 });
 
+const READ_ATTENTION_SUPPORT = Object.freeze({
+  claude: Object.freeze({ rendered: true }),
+  cursor: Object.freeze({ rendered: false, reason: 'no-read-context-surface' }),
+  codex: Object.freeze({ rendered: false, reason: 'global-config' }),
+  hermes: Object.freeze({ rendered: false, reason: 'global-config' }),
+});
+
 // Per-harness session-END (capture-on-exit) capability. Only Claude exposes native
 // PreCompact + Stop hook surfaces where Forge can snapshot session learnings BEFORE
 // context is compacted or the session ends. Cursor 1.7 hooks are deny-oriented with no
@@ -161,7 +169,7 @@ function adapterInvocation(harness) {
  * (per-commit) so the rendered Claude PreToolUse groups read write-guard first.
  */
 const FORGE_HOOK_CONTRACT = Object.freeze({
-  schemaVersion: '1.2.0',
+  schemaVersion: '1.3.0',
   kind: 'forge.hookContract',
   adapter: FORGE_HOOK_ADAPTER,
   intents: Object.freeze([
@@ -215,6 +223,14 @@ const FORGE_HOOK_CONTRACT = Object.freeze({
       lifecycle: 'user-prompt-submit',
       command: `${FORGE_CLI} hooks memory-recall`,
     }),
+    Object.freeze({
+      id: 'read-attention',
+      kind: 'context',
+      cliAction: 'read-attention',
+      enforces: 'Read attention: on supported PreToolUse:Read surfaces, inject only memory explicitly scoped to the path being opened. Content is fenced as untrusted, capped, additive, fail-open, and never mutates authority.',
+      lifecycle: 'pre-tool-read',
+      command: `${FORGE_CLI} hooks read-attention`,
+    }),
     Object.freeze({
       id: 'shepherd-events',
       kind: 'context',
@@ -294,6 +310,10 @@ function userPromptSubmitCapability(harness) {
   return USER_PROMPT_SUBMIT_SUPPORT[harness] || { rendered: false, reason: 'unknown-harness' };
 }
 
+function readAttentionCapability(harness) {
+  return READ_ATTENTION_SUPPORT[harness] || { rendered: false, reason: 'unknown-harness' };
+}
+
 /**
  * Report the per-harness session-END (capture-on-exit) capability (the honest matrix for
  * the PreCompact + Stop capture tier).
@@ -321,6 +341,10 @@ function renderClaudeHooks(contract) {
         matcher: 'Bash',
         hooks: [{ type: 'command', command: harnessCommand(contract, 'tdd-gate', 'claude') }],
       },
+      {
+        matcher: 'Read',
+        hooks: [{ type: 'command', command: harnessCommand(contract, 'read-attention', 'claude') }],
+      },
     ],
     // SessionStart context injection (memory push). No matcher → applies to every
     // session source; the command emits { hookSpecificOutput.additionalContext }.
@@ -438,6 +462,7 @@ function isForgeCommand(command) {
       || command.includes(FORGE_INBOX_CONTEXT_MARKER)
       || command.includes(FORGE_SHEPHERD_EVENTS_MARKER)
       || command.includes(FORGE_MEMORY_RECALL_MARKER)
+      || command.includes(FORGE_READ_ATTENTION_MARKER)
       || command.includes(FORGE_CAPTURE_CONTEXT_MARKER));
 }
 
@@ -651,13 +676,16 @@ module.exports = {
   FORGE_CONTEXT_MARKER,
   FORGE_INBOX_CONTEXT_MARKER,
   FORGE_MEMORY_RECALL_MARKER,
+  FORGE_READ_ATTENTION_MARKER,
   FORGE_CAPTURE_CONTEXT_MARKER,
   SESSION_START_SUPPORT,
   BOOTSTRAP_DELIVERY,
   USER_PROMPT_SUBMIT_SUPPORT,
+  READ_ATTENTION_SUPPORT,
   SESSION_END_SUPPORT,
   sessionStartCapability,
   userPromptSubmitCapability,
+  readAttentionCapability,
   sessionEndCapability,
   HookConfigParseError,
   renderClaudeHooks,

package/lib/issue-render.js

@@ -114,6 +114,19 @@ function pushSection(lines, label, text) {
   lines.push('', `${label}:`, text);
 }
 
+function renderReadinessReason(reason) {
+	if (!reason || typeof reason !== 'object') return String(reason ?? 'unknown');
+	const detail = reason.field || reason.issue_id || reason.gate || reason.actor || reason.status;
+	const parts = [];
+	if (detail) parts.push(String(detail));
+	if (reason.expected !== undefined) parts.push(`expected ${JSON.stringify(reason.expected)}`);
+	if (reason.actual !== undefined) parts.push(`actual ${JSON.stringify(reason.actual)}`);
+	if (reason.declared !== undefined) parts.push(`declared ${JSON.stringify(reason.declared)}`);
+	return parts.length > 0
+		? `${reason.code} (${parts.join(', ')})`
+		: String(reason.code || 'unknown');
+}
+
 // forge show: the full detail view. This is the surface that prints the FULL id
 // (list/ready show only the 8-char prefix), so every field a script or human
 // needs to act on the issue is reachable without --json.
@@ -135,6 +148,12 @@ function renderIssueShow(envelope) {
   pushField(lines, 'Claimed by', issue.claimed_by);
   pushField(lines, 'Parent', shortId(issue.parent_id ?? null) || null);
   pushField(lines, 'Blocked by', Array.isArray(issue.blocked_by) ? issue.blocked_by.map(shortId) : null);
+	pushField(lines, 'Readiness', issue.readiness_state);
+	pushField(
+		lines,
+		'Readiness reasons',
+		Array.isArray(issue.readiness_reasons) ? issue.readiness_reasons.map(renderReadinessReason) : null,
+	);
   pushField(lines, 'Dependencies', Array.isArray(issue.dependencies) ? issue.dependencies.map(shortId) : null);
   pushField(lines, 'Dependents', Array.isArray(issue.dependents) ? issue.dependents.map(shortId) : null);
   pushField(lines, 'Created', issue.created_at);