prjct-cli 0.45.4 → 0.45.5

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.45.5] - 2026-01-30
+
+### Bug Fixes
+
+- implement silent memory application - PRJ-103 (#69)
+
+
+## [0.45.5] - 2026-01-29
+
+### Changed
+
+- Remove meta-commentary from memory output (PRJ-103)
+  - "LEARNED PATTERNS" → "PROJECT DEFAULTS"
+  - "RELEVANT MEMORIES" → "CONTEXT"
+  - "Learned Patterns" → "Project Conventions"
+
+### Added
+
+- `lint:meta` script to catch meta-commentary anti-patterns
+
+
 ## [0.45.4] - 2026-01-29
 
 ### Bug Fixes

package/core/agentic/prompt-builder.ts

@@ -174,7 +174,7 @@ class PromptBuilder {
     try {
       const patterns = await outcomeAnalyzer.detectPatterns(projectId)
       if (patterns.length > 0) {
-        parts.push('**Learned Patterns**')
+        parts.push('**Project Conventions**')
         for (const pattern of patterns.slice(0, 3)) {
           parts.push(`- ${pattern.description}`)
           if (pattern.suggestedAction) {
@@ -489,7 +489,7 @@ class PromptBuilder {
 
     // P1.1: Learned Patterns
     if (learnedPatterns && Object.keys(learnedPatterns).some((k) => learnedPatterns[k])) {
-      parts.push('\n## LEARNED PATTERNS (use these, do NOT ask user)\n')
+      parts.push('\n## PROJECT DEFAULTS (apply automatically)\n')
       for (const [key, value] of Object.entries(learnedPatterns)) {
         if (value) {
           parts.push(`- ${key}: ${value}\n`)
@@ -511,7 +511,7 @@ class PromptBuilder {
 
     // P3.3: Relevant Memories
     if (relevantMemories && relevantMemories.length > 0) {
-      parts.push('\n## RELEVANT MEMORIES (apply these learnings)\n')
+      parts.push('\n## CONTEXT (apply these)\n')
       for (const memory of relevantMemories) {
         parts.push(`- **${memory.title}**: ${memory.content}\n`)
         if (memory.tags && memory.tags.length > 0) {

package/core/cli/lint-meta-commentary.ts

@@ -0,0 +1,177 @@
+#!/usr/bin/env bun
+/**
+ * Lint rule: no-meta-commentary
+ *
+ * Catches AI memory meta-commentary patterns that should be avoided.
+ * Preferences should be presented as facts, not as memories.
+ *
+ * Anti-patterns:
+ * - "I remember you prefer..."
+ * - "Based on your history..."
+ * - "I've learned that..."
+ * - "From previous sessions..."
+ *
+ * Correct pattern:
+ * - "Use TypeScript strict mode" (not "I remember you like strict mode")
+ *
+ * @see PRJ-103
+ */
+
+import { readdir, readFile } from 'node:fs/promises'
+import { join, relative } from 'node:path'
+
+const META_COMMENTARY_PATTERNS = [
+  // Direct memory references
+  /\bI remember\b/gi,
+  /\bI recall\b/gi,
+  /\bI('ve| have) learned\b/gi,
+
+  // History references
+  /\bBased on (your |)history\b/gi,
+  /\bFrom previous (session|conversation)s?\b/gi,
+  /\bIn (the |)past,? you\b/gi,
+
+  // Preference meta-commentary
+  /\byou (usually|typically|always|often) prefer\b/gi,
+  /\byou mentioned (before|earlier|previously)\b/gi,
+  /\blast time you\b/gi,
+
+  // Section headers that expose memory mechanism
+  /\bLEARNED PATTERNS\b/g,
+  /\bRELEVANT MEMORIES\b/g,
+  /\bLearned Patterns\b/g,
+  /\bRelevant Memories\b/g,
+]
+
+// Files/directories to skip
+const SKIP_PATTERNS = [
+  /node_modules/,
+  /\.git/,
+  /dist/,
+  /build/,
+  /coverage/,
+  /\.test\.ts$/,
+  /\.spec\.ts$/,
+  /lint-meta-commentary\.ts$/, // Skip self
+  /\/docs\//, // Skip documentation (describes features, not agent output)
+]
+
+// Only check these extensions
+const INCLUDE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.md']
+
+interface Violation {
+  file: string
+  line: number
+  column: number
+  match: string
+  pattern: string
+}
+
+async function* walkDir(dir: string): AsyncGenerator<string> {
+  const entries = await readdir(dir, { withFileTypes: true })
+
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name)
+
+    if (SKIP_PATTERNS.some((p) => p.test(fullPath))) {
+      continue
+    }
+
+    if (entry.isDirectory()) {
+      yield* walkDir(fullPath)
+    } else if (entry.isFile() && INCLUDE_EXTENSIONS.some((ext) => entry.name.endsWith(ext))) {
+      yield fullPath
+    }
+  }
+}
+
+async function checkFile(filePath: string): Promise<Violation[]> {
+  const violations: Violation[] = []
+  const content = await readFile(filePath, 'utf-8')
+  const lines = content.split('\n')
+
+  for (let lineNum = 0; lineNum < lines.length; lineNum++) {
+    const line = lines[lineNum]
+
+    // Skip comments - we only care about string literals that become agent output
+    const trimmed = line.trim()
+    if (
+      trimmed.startsWith('//') || // Inline comments
+      trimmed.startsWith('*') || // JSDoc/block comments
+      trimmed.startsWith('/*') || // Block comment start
+      line.includes('Anti-pattern') || // Documentation
+      line.includes('@see') || // JSDoc refs
+      line.includes('@example') // JSDoc examples
+    ) {
+      continue
+    }
+
+    for (const pattern of META_COMMENTARY_PATTERNS) {
+      // Reset lastIndex for global patterns
+      pattern.lastIndex = 0
+
+      let match: RegExpExecArray | null
+      while ((match = pattern.exec(line)) !== null) {
+        violations.push({
+          file: filePath,
+          line: lineNum + 1,
+          column: match.index + 1,
+          match: match[0],
+          pattern: pattern.source,
+        })
+      }
+    }
+  }
+
+  return violations
+}
+
+async function main() {
+  const rootDir = process.cwd()
+  const allViolations: Violation[] = []
+
+  console.log('Checking for meta-commentary patterns...\n')
+
+  for await (const filePath of walkDir(rootDir)) {
+    const violations = await checkFile(filePath)
+    if (violations.length > 0) {
+      allViolations.push(...violations)
+    }
+  }
+
+  if (allViolations.length === 0) {
+    console.log('✅ No meta-commentary patterns found\n')
+    process.exit(0)
+  }
+
+  console.log(`❌ Found ${allViolations.length} meta-commentary violation(s):\n`)
+
+  // Group by file
+  const byFile = new Map<string, Violation[]>()
+  for (const v of allViolations) {
+    const rel = relative(rootDir, v.file)
+    if (!byFile.has(rel)) {
+      byFile.set(rel, [])
+    }
+    byFile.get(rel)!.push(v)
+  }
+
+  for (const [file, violations] of byFile) {
+    console.log(`  ${file}`)
+    for (const v of violations) {
+      console.log(`    ${v.line}:${v.column}  "${v.match}"`)
+    }
+    console.log('')
+  }
+
+  console.log('Fix: Present preferences as facts, not memories.')
+  console.log('  ❌ "I remember you prefer TypeScript"')
+  console.log('  ✅ "Use TypeScript"\n')
+
+  process.exit(1)
+}
+
+main().catch((err) => {
+  console.error('Error:', err.message)
+  process.exit(1)
+})

package/dist/bin/prjct.mjs

@@ -12055,7 +12055,7 @@ var init_prompt_builder = __esm({
         try {
           const patterns = await analyzer_default.detectPatterns(projectId);
           if (patterns.length > 0) {
-            parts.push("**Learned Patterns**");
+            parts.push("**Project Conventions**");
             for (const pattern of patterns.slice(0, 3)) {
               parts.push(`- ${pattern.description}`);
               if (pattern.suggestedAction) {
@@ -12315,7 +12315,7 @@ Stack: ${stack}
         }
         parts.push(this.buildCriticalRules());
         if (learnedPatterns && Object.keys(learnedPatterns).some((k) => learnedPatterns[k])) {
-          parts.push("\n## LEARNED PATTERNS (use these, do NOT ask user)\n");
+          parts.push("\n## PROJECT DEFAULTS (apply automatically)\n");
           for (const [key, value] of Object.entries(learnedPatterns)) {
             if (value) {
               parts.push(`- ${key}: ${value}
@@ -12337,7 +12337,7 @@ Stack: ${stack}
 `);
         }
         if (relevantMemories && relevantMemories.length > 0) {
-          parts.push("\n## RELEVANT MEMORIES (apply these learnings)\n");
+          parts.push("\n## CONTEXT (apply these)\n");
           for (const memory of relevantMemories) {
             parts.push(`- **${memory.title}**: ${memory.content}
 `);
@@ -23330,7 +23330,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.45.4",
+      version: "0.45.5",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {
@@ -23359,6 +23359,7 @@ var require_package = __commonJS({
         validate: "bun scripts/validate-commands.js",
         lint: "biome lint .",
         "lint:fix": "biome lint --write .",
+        "lint:meta": "bun core/cli/lint-meta-commentary.ts",
         format: "biome format --write .",
         "format:check": "biome format .",
         check: "biome check .",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.45.4",
+  "version": "0.45.5",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {
@@ -29,6 +29,7 @@
     "validate": "bun scripts/validate-commands.js",
     "lint": "biome lint .",
     "lint:fix": "biome lint --write .",
+    "lint:meta": "bun core/cli/lint-meta-commentary.ts",
     "format": "biome format --write .",
     "format:check": "biome format .",
     "check": "biome check .",