hone-ai 0.14.0 → 0.15.0

package/README.md

@@ -1,9 +1,17 @@
-# hone
+# hone-ai
 
 **AI Coding Agent Orchestrator** — Automatically implement features from requirements using AI agents.
 
 Transform feature ideas into working code through autonomous development with human oversight.
 
+## Why
+
+When working on long running tasks with agents, their context window fills up and the performance degrades. To mitigate this, hone-ai provides a solution starting each new iteration with a fresh context window just passing in a summary of the progress made so far on the specific PRD, repository architecture and gotchas, and any other relevant information.
+
+Everything else is stripped away, leaving only the essential information needed for the next iteration. This approach helps maintain optimal performance and reduces the likelihood of context drift.
+
+It's a surprisingly powerful process.
+
 ## Quick Start
 
 1. **Install hone**
@@ -12,6 +20,8 @@ Transform feature ideas into working code through autonomous development with hu
    npm install -g hone-ai
    # or
    bun add -g hone-ai
+   # or
+   # download binary or build from source, instructions below
    ```
 
 2. **Install an AI agent** ([OpenCode](https://opencode.ai) or [Claude Code](https://docs.anthropic.com/claude/docs/claude-code))
@@ -27,7 +37,7 @@ That's it! You're ready to use hone.
 ## Common Workflow
 
 ```bash
-# 1. Generate project documentation (if no AGENTS.md exists)
+# 1. Generate project documentation (if no AGENTS.md exists). A one time thing.
 hone agents-md
 
 # 2. Create a PRD from your feature description

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hone-ai",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "AI coding agent orchestrator - orchestrate AI agents to implement features based on PRDs",
   "keywords": [
     "ai",

package/src/agents-md-generator.ts

@@ -12,7 +12,7 @@ import {
 } from './config'
 import { readFile, writeFile, mkdir } from 'fs/promises'
 import { join } from 'path'
-import { existsSync } from 'fs'
+import { existsSync, readFileSync } from 'fs'
 import { AgentClient } from './agent-client'
 import { log, logError, logVerbose, logVerboseError } from './logger'
 
@@ -424,12 +424,103 @@ async function executeParallelScanning(
   return scanResults
 }
 
+/**
+ * Generate project-specific feedback commands based on package.json and project files
+ */
+function generateFeedbackContent(projectPath: string, analysis: ProjectAnalysis): string {
+  const feedbackCommands: string[] = []
+
+  // Read package.json to get actual project scripts
+  let packageJsonScripts: Record<string, string> = {}
+  try {
+    const packageJsonPath = join(projectPath, 'package.json')
+    if (existsSync(packageJsonPath)) {
+      const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'))
+      packageJsonScripts = packageJson.scripts || {}
+    }
+  } catch (error) {
+    logVerbose('[AgentsMd] Could not read package.json scripts')
+  }
+
+  // Unit tests - use actual package.json scripts or detected framework
+  if (packageJsonScripts.test) {
+    feedbackCommands.push(`**Unit Tests:** \`npm run test\` or \`${packageJsonScripts.test}\``)
+  } else if (analysis.testingFrameworks.some(fw => fw.toLowerCase().includes('jest'))) {
+    feedbackCommands.push('**Unit Tests:** `npm test` or `jest`')
+  } else if (analysis.testingFrameworks.some(fw => fw.toLowerCase().includes('pytest'))) {
+    feedbackCommands.push('**Unit Tests:** `pytest`')
+  } else if (analysis.testingFrameworks.some(fw => fw.toLowerCase().includes('bun'))) {
+    feedbackCommands.push('**Unit Tests:** `bun test`')
+  } else {
+    feedbackCommands.push('**Unit Tests:** `bun test`')
+  }
+
+  // Code formatting - use actual package.json scripts if available
+  if (packageJsonScripts.format) {
+    feedbackCommands.push(
+      `**Code Formatting:** \`npm run format\` or \`${packageJsonScripts.format}\``
+    )
+  } else if (
+    analysis.languages.some(
+      lang => lang.toLowerCase().includes('typescript') || lang.toLowerCase().includes('javascript')
+    )
+  ) {
+    feedbackCommands.push('**Code Formatting:** `prettier --write "**/*.{ts,tsx,js,jsx}"`')
+  }
+
+  // Code linting - check for lint script or eslint
+  if (packageJsonScripts.lint) {
+    feedbackCommands.push(`**Code Linting:** \`npm run lint\` or \`${packageJsonScripts.lint}\``)
+  } else if (
+    analysis.languages.some(
+      lang => lang.toLowerCase().includes('typescript') || lang.toLowerCase().includes('javascript')
+    )
+  ) {
+    feedbackCommands.push('**Code Linting:** `eslint . --fix`')
+  }
+
+  // YAML formatting and linting from package.json scripts
+  if (packageJsonScripts['format:yaml']) {
+    feedbackCommands.push(
+      `**YAML Formatting:** \`npm run format:yaml\` or \`${packageJsonScripts['format:yaml']}\``
+    )
+  }
+  if (packageJsonScripts['lint:yaml']) {
+    feedbackCommands.push(
+      `**YAML Linting:** \`npm run lint:yaml\` or \`${packageJsonScripts['lint:yaml']}\``
+    )
+  }
+
+  // Build command - use actual package.json scripts or detected build systems
+  if (packageJsonScripts.build) {
+    feedbackCommands.push(`**Build:** \`npm run build\` or \`${packageJsonScripts.build}\``)
+  } else if (analysis.buildSystems.length > 0) {
+    const buildSystems = analysis.buildSystems.map(sys => sys.toLowerCase())
+    if (buildSystems.some(sys => sys.includes('bun'))) {
+      feedbackCommands.push('**Build:** `bun run build`')
+    } else if (buildSystems.some(sys => sys.includes('npm') || sys.includes('yarn'))) {
+      feedbackCommands.push('**Build:** `npm run build` or `yarn build`')
+    } else if (buildSystems.some(sys => sys.includes('maven'))) {
+      feedbackCommands.push('**Build:** `mvn clean compile`')
+    } else if (buildSystems.some(sys => sys.includes('gradle'))) {
+      feedbackCommands.push('**Build:** `./gradlew build`')
+    }
+  }
+
+  return `Run these commands to validate your changes before committing:
+
+${feedbackCommands.join('\n\n')}
+
+These commands are project-specific based on the configured scripts and tooling.`
+}
+
 /**
  * Create adaptive template sections based on discovered tech stack
  */
 function createTemplateSections(
   scanResults: Record<keyof typeof DISCOVERY_PROMPTS, string>,
-  analysis: ProjectAnalysis
+  analysis: ProjectAnalysis,
+  projectPath: string
 ): TemplateSection[] {
   const sections: TemplateSection[] = []
 
@@ -500,6 +591,14 @@ function createTemplateSections(
     })
   }
 
+  // Add feedback section inline at the top with project-specific commands
+  sections.push({
+    title: 'Feedback Instructions',
+    content: generateFeedbackContent(projectPath, analysis),
+    priority: 0, // Highest priority to appear at top
+    detailFile: undefined, // Force inline, never create separate file
+  })
+
   // Sort by priority
   return sections.sort((a, b) => a.priority - b.priority)
 }
@@ -543,16 +642,25 @@ ${section.content}
     )
   }
 
-  // Compact version with references to ${AGENTS_DOCS_DIR}/ files
+  // Compact version with references to ${AGENTS_DOCS_DIR}/ files, but keep inline sections inline
   const compactSections = sections
-    .map(
-      section => `## ${section.title}
+    .map(section => {
+      // If section has no detailFile, render it inline (like Feedback Instructions)
+      if (!section.detailFile) {
+        return `## ${section.title}
+
+${section.content}
+`
+      }
+
+      // Otherwise, use compact format with reference to detail file
+      return `## ${section.title}
 
 ${getFirstSentence(section.content)}
 
 See [@${AGENTS_DOCS_DIR}/${section.detailFile}](${AGENTS_DOCS_DIR}/${section.detailFile}) for detailed information.
 `
-    )
+    })
     .join('\n')
 
   return (
@@ -680,7 +788,7 @@ async function generateContent(
     log('-'.repeat(80))
 
     // Create adaptive template sections based on discovered tech stack
-    const sections = createTemplateSections(scanResults, analysis)
+    const sections = createTemplateSections(scanResults, analysis, projectPath)
 
     // Generate initial content to check line count
     const fullContent = generateCompactContent(sections, false)

package/src/prompt.ts

@@ -262,7 +262,7 @@ ${reviewFeedback || 'No review feedback provided (review was skipped or approved
      Next Task: <next-task-id> or "All tasks complete"
      \`\`\`
 
-5. **Update AGENTS.md** (if learnings exist)
+5. **Update AGENTS.md file**
    - Add useful learnings and gotchas under appropriate heading
    - Be terse - only add truly useful info that future agents need
    - Don't duplicate existing info