claude-mem 12.7.0 → 12.7.2

package/plugin/skills/babysit/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: babysit
+description: Watch a pull request or review cycle until it is ready to merge. Use when asked to babysit, monitor, or keep checking PR comments, reviews, and CI until all actionable issues are resolved.
+---
+
+# Babysit PR
+
+Stay with the PR until it is actually clean. Do not stop after one check pass if comments or review threads are still unresolved.
+
+## Workflow
+
+1. Identify the PR number, branch, and base branch.
+2. Confirm the PR is not draft and inspect mergeability, checks, review decision, comments, and review threads.
+3. Watch pending checks until they finish. Poll at a practical interval, usually 30-60 seconds unless the user asks for a different cadence.
+4. Read new comments and unresolved review threads. Treat bot summaries as useful, but verify actionable findings against the code.
+5. Fix real issues in focused commits, run relevant tests/builds, push, and return to step 2.
+6. Resolve stale review threads only after verifying the code or generated artifact now addresses the comment.
+7. Stop only when checks are passing or intentionally skipped, review decision is acceptable, no actionable comments remain, and no unresolved review threads remain.
+
+## GitHub CLI Checks
+
+Use `gh pr view` for the coarse status:
+
+```bash
+gh pr view <number> --json \
+  number,state,isDraft,mergeable,mergeStateStatus,reviewDecision,headRefOid,statusCheckRollup,url
+```
+
+Resolve the repository owner/name before using GraphQL:
+
+```bash
+repo_json=$(gh repo view --json owner,name)
+owner=$(jq -r '.owner.login // .owner.name' <<<"$repo_json")
+repo=$(jq -r '.name' <<<"$repo_json")
+```
+
+Use GraphQL for unresolved review threads. Include `pageInfo`; omit `cursor` on the first page, then pass the previous `endCursor` with `-f cursor="$cursor"` while `hasNextPage` is `true`.
+
+```bash
+gh api graphql \
+  -f query='query($owner:String!,$repo:String!,$number:Int!,$cursor:String){repository(owner:$owner,name:$repo){pullRequest(number:$number){reviewThreads(first:100,after:$cursor){pageInfo{hasNextPage endCursor}nodes{id,isResolved,isOutdated,path,line,comments(last:1){nodes{author{login},body,createdAt,url}}}}}}}' \
+  -f owner="$owner" -f repo="$repo" -F number=<number>
+```
+
+Use this loop when a PR may have many review threads:
+
+```bash
+thread_query='query($owner:String!,$repo:String!,$number:Int!,$cursor:String){repository(owner:$owner,name:$repo){pullRequest(number:$number){reviewThreads(first:100,after:$cursor){pageInfo{hasNextPage endCursor}nodes{id,isResolved,isOutdated,path,line,comments(last:1){nodes{author{login},body,createdAt,url}}}}}}}'
+cursor_args=()
+
+while :; do
+  page=$(gh api graphql -f query="$thread_query" -f owner="$owner" -f repo="$repo" -F number=<number> "${cursor_args[@]}")
+  printf '%s\n' "$page" | jq -r '.data.repository.pullRequest.reviewThreads.nodes[]
+    | select(.isResolved==false)
+    | [.id,.path,(.line//""),(.isOutdated|tostring),(.comments.nodes[-1].author.login//""),(.comments.nodes[-1].body|gsub("\n";" ")|.[0:240])]
+    | @tsv'
+
+  jq -e '.data.repository.pullRequest.reviewThreads.pageInfo.hasNextPage' >/dev/null <<<"$page" || break
+  cursor=$(jq -r '.data.repository.pullRequest.reviewThreads.pageInfo.endCursor' <<<"$page")
+  cursor_args=(-f cursor="$cursor")
+done
+```
+
+Filter unresolved threads with `jq`:
+
+```bash
+jq -r '.data.repository.pullRequest.reviewThreads.nodes[]
+  | select(.isResolved==false)
+  | [.id,.path,(.line//""),(.isOutdated|tostring),(.comments.nodes[-1].author.login//""),(.comments.nodes[-1].body|gsub("\n";" ")|.[0:240])]
+  | @tsv'
+```
+
+Resolve a stale thread only when the fix is verified:
+
+```bash
+gh api graphql \
+  -f query='mutation($threadId:ID!){resolveReviewThread(input:{threadId:$threadId}){thread{id,isResolved}}}' \
+  -f threadId=<thread-id>
+```
+
+## Operating Rules
+
+- Keep the watcher running while long checks are pending.
+- If a generated file is part of the distribution, verify the source and generated artifact agree before resolving comments.
+- If a bot reports an issue against stale code, confirm whether the thread is outdated or addressed in the latest head.
+- Before final reporting, do one fresh sweep of PR status, unresolved threads, recent comments, and local `git status`.
+- Report concrete evidence: latest commit SHA, check names and results, unresolved thread count, tests run, and any dirty local files left untouched.

package/dist/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Claude-Mem - TypeScript Declarations
- *
- * Re-exports SDK utilities for convenience.
- */
-
-export * from './sdk/index.js';

package/dist/index.js

@@ -1,8 +0,0 @@
-/**
- * Claude-Mem - Main Package Entry Point
- *
- * This re-exports the SDK utilities for convenience.
- * For full SDK access, use: import { ... } from 'claude-mem/sdk'
- */
-
-export * from './sdk/index.js';

package/dist/sdk/index.d.ts

@@ -1,109 +0,0 @@
-/**
- * Claude-Mem SDK - TypeScript Declarations
- *
- * Standalone module for external consumers to parse claude-mem observation XML
- * and build prompts for the memory worker.
- */
-
-export interface ParsedObservation {
-  type: string;
-  title: string | null;
-  subtitle: string | null;
-  facts: string[];
-  narrative: string | null;
-  concepts: string[];
-  files_read: string[];
-  files_modified: string[];
-}
-
-export interface ParsedSummary {
-  request: string | null;
-  investigated: string | null;
-  learned: string | null;
-  completed: string | null;
-  next_steps: string | null;
-  notes: string | null;
-}
-
-export interface Observation {
-  id: number;
-  tool_name: string;
-  tool_input: string;
-  tool_output: string;
-  created_at_epoch: number;
-  cwd?: string;
-}
-
-export interface ParseObservationsOptions {
-  /** Array of valid observation types. If provided, validates types against this list. */
-  validTypes?: string[];
-  /** Type to use if type is missing or invalid. Defaults to 'observation'. */
-  fallbackType?: string;
-}
-
-/**
- * Parse observation XML blocks from text
- * Returns all observations found in the text
- *
- * @param text - The text containing observation XML blocks
- * @param options - Optional configuration for type validation
- * @returns Array of parsed observations
- *
- * @example
- * ```typescript
- * const text = `<observation>
- *   <type>code_change</type>
- *   <title>Added login feature</title>
- *   <facts><fact>New auth module</fact></facts>
- * </observation>`;
- *
- * const observations = parseObservations(text);
- * // => [{ type: 'code_change', title: 'Added login feature', ... }]
- * ```
- */
-export function parseObservations(
-  text: string,
-  options?: ParseObservationsOptions
-): ParsedObservation[];
-
-/**
- * Parse summary XML block from text
- * Returns null if no valid summary found or if summary was skipped
- *
- * @param text - The text containing summary XML block
- * @returns Parsed summary or null
- *
- * @example
- * ```typescript
- * const text = `<summary>
- *   <request>Implement auth</request>
- *   <completed>Added JWT tokens</completed>
- * </summary>`;
- *
- * const summary = parseSummary(text);
- * // => { request: 'Implement auth', completed: 'Added JWT tokens', ... }
- * ```
- */
-export function parseSummary(text: string): ParsedSummary | null;
-
-/**
- * Build prompt to send tool observation to SDK agent
- *
- * @param obs - The observation object containing tool data
- * @returns Formatted XML prompt string
- *
- * @example
- * ```typescript
- * const obs = {
- *   id: 1,
- *   tool_name: 'Read',
- *   tool_input: '{"file_path": "/src/index.ts"}',
- *   tool_output: '{"content": "..."}',
- *   created_at_epoch: Date.now()
- * };
- *
- * const prompt = buildObservationPrompt(obs);
- * // => '<observed_from_primary_session>...'
- * ```
- */
-export function buildObservationPrompt(obs: Observation): string;

package/dist/sdk/index.js

@@ -1,183 +0,0 @@
-/**
- * Claude-Mem SDK - Standalone module for external consumers
- *
- * This is a self-contained module that exports parsing and prompt utilities
- * without internal dependencies on the main claude-mem codebase.
- *
- * Usage:
- *   import { parseObservations, buildObservationPrompt } from 'claude-mem/sdk';
- */
-
-// ============================================================================
-// Parser Functions
-// ============================================================================
-
-/**
- * Parse observation XML blocks from text
- * Returns all observations found in the text
- *
- * @param {string} text - The text containing observation XML blocks
- * @param {Object} [options] - Optional configuration
- * @param {string[]} [options.validTypes] - Array of valid observation types. If provided, validates types.
- * @param {string} [options.fallbackType='observation'] - Type to use if type is missing or invalid
- * @returns {ParsedObservation[]} Array of parsed observations
- */
-export function parseObservations(text, options = {}) {
-  const observations = [];
-  const { validTypes, fallbackType = 'observation' } = options;
-
-  // Match <observation>...</observation> blocks (non-greedy)
-  const observationRegex = /<observation>([\s\S]*?)<\/observation>/g;
-
-  let match;
-  while ((match = observationRegex.exec(text)) !== null) {
-    const obsContent = match[1];
-
-    // Extract all fields
-    const type = extractField(obsContent, 'type');
-    const title = extractField(obsContent, 'title');
-    const subtitle = extractField(obsContent, 'subtitle');
-    const narrative = extractField(obsContent, 'narrative');
-    const facts = extractArrayElements(obsContent, 'facts', 'fact');
-    const concepts = extractArrayElements(obsContent, 'concepts', 'concept');
-    const files_read = extractArrayElements(obsContent, 'files_read', 'file');
-    const files_modified = extractArrayElements(obsContent, 'files_modified', 'file');
-
-    // Determine final type
-    let finalType = fallbackType;
-    if (type) {
-      const trimmedType = type.trim();
-      if (validTypes) {
-        finalType = validTypes.includes(trimmedType) ? trimmedType : fallbackType;
-      } else {
-        finalType = trimmedType;
-      }
-    }
-
-    // Filter out type from concepts array (types and concepts are separate dimensions)
-    const cleanedConcepts = concepts.filter(c => c !== finalType);
-
-    observations.push({
-      type: finalType,
-      title,
-      subtitle,
-      facts,
-      narrative,
-      concepts: cleanedConcepts,
-      files_read,
-      files_modified
-    });
-  }
-
-  return observations;
-}
-
-/**
- * Parse summary XML block from text
- * Returns null if no valid summary found or if summary was skipped
- *
- * @param {string} text - The text containing summary XML block
- * @returns {ParsedSummary|null} Parsed summary or null
- */
-export function parseSummary(text) {
-  // Check for skip_summary first
-  const skipRegex = /<skip_summary\s+reason="([^"]+)"\s*\/>/;
-  const skipMatch = skipRegex.exec(text);
-
-  if (skipMatch) {
-    return null;
-  }
-
-  // Match <summary>...</summary> block (non-greedy)
-  const summaryRegex = /<summary>([\s\S]*?)<\/summary>/;
-  const summaryMatch = summaryRegex.exec(text);
-
-  if (!summaryMatch) {
-    return null;
-  }
-
-  const summaryContent = summaryMatch[1];
-
-  return {
-    request: extractField(summaryContent, 'request'),
-    investigated: extractField(summaryContent, 'investigated'),
-    learned: extractField(summaryContent, 'learned'),
-    completed: extractField(summaryContent, 'completed'),
-    next_steps: extractField(summaryContent, 'next_steps'),
-    notes: extractField(summaryContent, 'notes')
-  };
-}
-
-/**
- * Extract a simple field value from XML content
- * Returns null for missing or empty/whitespace-only fields
- */
-function extractField(content, fieldName) {
-  const regex = new RegExp(`<${fieldName}>([^<]*)</${fieldName}>`);
-  const match = regex.exec(content);
-  if (!match) return null;
-
-  const trimmed = match[1].trim();
-  return trimmed === '' ? null : trimmed;
-}
-
-/**
- * Extract array of elements from XML content
- */
-function extractArrayElements(content, arrayName, elementName) {
-  const elements = [];
-
-  // Match the array block
-  const arrayRegex = new RegExp(`<${arrayName}>(.*?)</${arrayName}>`, 's');
-  const arrayMatch = arrayRegex.exec(content);
-
-  if (!arrayMatch) {
-    return elements;
-  }
-
-  const arrayContent = arrayMatch[1];
-
-  // Extract individual elements
-  const elementRegex = new RegExp(`<${elementName}>([^<]+)</${elementName}>`, 'g');
-  let elementMatch;
-  while ((elementMatch = elementRegex.exec(arrayContent)) !== null) {
-    elements.push(elementMatch[1].trim());
-  }
-
-  return elements;
-}
-
-// ============================================================================
-// Prompt Building Functions
-// ============================================================================
-
-/**
- * Build prompt to send tool observation to SDK agent
- *
- * @param {Observation} obs - The observation object containing tool data
- * @returns {string} Formatted XML prompt string
- */
-export function buildObservationPrompt(obs) {
-  // Safely parse tool_input and tool_output - they may be JSON strings
-  let toolInput;
-  let toolOutput;
-
-  try {
-    toolInput = typeof obs.tool_input === 'string' ? JSON.parse(obs.tool_input) : obs.tool_input;
-  } catch {
-    toolInput = obs.tool_input;
-  }
-
-  try {
-    toolOutput = typeof obs.tool_output === 'string' ? JSON.parse(obs.tool_output) : obs.tool_output;
-  } catch {
-    toolOutput = obs.tool_output;
-  }
-
-  return `<observed_from_primary_session>
-  <what_happened>${obs.tool_name}</what_happened>
-  <occurred_at>${new Date(obs.created_at_epoch).toISOString()}</occurred_at>${obs.cwd ? `\n  <working_directory>${obs.cwd}</working_directory>` : ''}
-  <parameters>${JSON.stringify(toolInput, null, 2)}</parameters>
-  <outcome>${JSON.stringify(toolOutput, null, 2)}</outcome>
-</observed_from_primary_session>`;
-}