thachvd-kit 1.0.5 → 1.0.7

package/README.md

@@ -18,6 +18,7 @@ npx github:thachvd/thachvd-kit init
 The interactive wizard will first ask whether this is a new project or an existing one.
 If it is an existing project, it can scan the current codebase to prefill `PROJECT_CONTEXT.md`, or let you enter everything manually.
 The scan mode uses evidence-based detectors and shows why a framework was inferred, so you can quickly confirm or correct it.
+After init, you can also generate an AI refinement prompt to let your editor/agent deepen the project context.
 
 ```bash
 thachvd-kit init --scan

package/bin/cli.js

@@ -842,9 +842,73 @@ Stack: ${data.primary_language} | ${(data.frameworks || []).join(', ')}
 - \`/test\` — Run test suite
 - \`/deploy\` — Deploy checklist
 
-See PROJECT_CONTEXT.md for full agent routing table.
-`;
-}
+See PROJECT_CONTEXT.md for full agent routing table.
+`;
+}
+
+function generateAiContextRefinementPrompt(data) {
+    const evidence = (data.scan_evidence || []).length > 0
+        ? (data.scan_evidence || []).map(line => `- ${line}`).join('\n')
+        : '- No scan evidence was captured during init.';
+
+    return `# AI Context Refinement
+
+Use this prompt in your AI editor after \`thachvd-kit init\`.
+
+## Goal
+
+Refine \`PROJECT_CONTEXT.md\` so it reflects the real project more accurately than the baseline init scan.
+
+## Current Baseline
+
+- Project: ${data.project_name}
+- Type: ${data.project_type}
+- Stack: ${data.primary_language} | ${(data.frameworks || []).join(', ') || 'no framework'}
+- Database: ${data.database || 'none'}
+- Infra: ${(data.infrastructure || []).join(', ') || 'none'}
+
+## Scan Evidence
+
+${evidence}
+
+## Instructions For The AI Agent
+
+1. Read \`PROJECT_CONTEXT.md\` first.
+2. Inspect the project selectively to improve factual accuracy.
+3. Prioritize:
+   - real database/config detection
+   - domain/capability inference
+   - architecture notes
+   - more accurate auto-resolved skills
+   - important project-specific constraints
+4. Update \`PROJECT_CONTEXT.md\` directly.
+5. Distinguish facts from inferences when uncertain.
+6. Do not implement product code in this pass. Only refine project context.
+
+## Suggested Files To Inspect
+
+- Root manifests: \`package.json\`, \`composer.json\`, \`Cargo.toml\`, \`pyproject.toml\`
+- Infrastructure/config: Docker, CI, env, framework config files
+- Database config and models
+- Main app entry points, routing, controllers/services
+- README and existing documentation
+
+## Desired Improvements
+
+- Correct the \`database\` field if config files reveal the real DB.
+- Add architecture notes that explain the actual structure.
+- Infer domain capabilities such as scraping, browser automation, external API integrations, queues, workers, etc.
+- Expand auto-resolved skills when there is clear evidence in the codebase.
+- Add caveats or assumptions if parts of the stack are still uncertain.
+
+## Completion Standard
+
+When done, summarize:
+- what was corrected
+- what is still inferred
+- which files provided the strongest evidence
+`;
+}
 
 // --- Main CLI ---
 
@@ -924,6 +988,8 @@ async function main() {
     }
 
     const scanned = useScan ? scanProject() : null;
+    let reviewScannedFields = !useScan;
+    let requestAiRefinement = false;
 
     if (useScan) {
         console.log(`${pc.bold('  Scan result:')} ${scanned.primary_language} | ${scanned.frameworks.join(', ') || 'no framework'}`);
@@ -933,20 +999,34 @@ async function main() {
             scanned.scan_evidence.forEach(line => console.log(`    · ${line}`));
             console.log('');
         }
+
+        if (!assumeYes) {
+            const scanAction = await askQuestions({
+                type: 'select',
+                name: 'scan_action',
+                message: 'Use detected context as-is or review fields manually?',
+                choices: [
+                    { title: 'Use detected context', value: 'accept' },
+                    { title: 'Review detected fields', value: 'review' }
+                ],
+                initial: 0
+            });
+            reviewScannedFields = scanAction.scan_action === 'review';
+        }
     }
 
     const { project_name, description, project_type } = await askQuestions([
-        { type: assumeYes ? null : 'text', name: 'project_name', message: 'Project name:', initial: scanned?.project_name || path.basename(targetDir) },
-        { type: assumeYes ? null : 'text', name: 'description', message: 'Short description:', initial: scanned?.description || 'A software project' },
+        { type: assumeYes || !reviewScannedFields ? null : 'text', name: 'project_name', message: 'Project name:', initial: scanned?.project_name || path.basename(targetDir) },
+        { type: assumeYes || !reviewScannedFields ? null : 'text', name: 'description', message: 'Short description:', initial: scanned?.description || 'A software project' },
         {
-            type: assumeYes ? null : 'select', name: 'project_type', message: 'Project type:',
+            type: assumeYes || !reviewScannedFields ? null : 'select', name: 'project_type', message: 'Project type:',
             choices: PROJECT_TYPE_CHOICES.map(value => ({ title: value, value })),
             initial: Math.max(PROJECT_TYPE_CHOICES.indexOf(scanned?.project_type || 'web-app'), 0)
         }
     ]);
 
     const { primary_language } = await askQuestions({
-        type: assumeYes ? null : 'select',
+        type: assumeYes || !reviewScannedFields ? null : 'select',
         name: 'primary_language',
         message: 'Primary language:',
         choices: LANGUAGE_CHOICES.map(l => ({ title: l, value: l })),
@@ -954,7 +1034,7 @@ async function main() {
     });
 
     const { frameworks } = await askQuestions({
-        type: assumeYes ? null : 'multiselect',
+        type: assumeYes || !reviewScannedFields ? null : 'multiselect',
         name: 'frameworks',
         message: 'Frameworks (Space to select, Enter to confirm):',
         choices: FRAMEWORK_CHOICES.map(f => ({ title: f, value: f, selected: (scanned?.frameworks || []).includes(f) })),
@@ -963,13 +1043,13 @@ async function main() {
 
     const dbAndInfra = await askQuestions([
         {
-            type: assumeYes ? null : 'select', name: 'database', message: 'Database / ORM:',
+            type: assumeYes || !reviewScannedFields ? null : 'select', name: 'database', message: 'Database / ORM:',
             choices: DATABASE_CHOICES.map(d => ({ title: d, value: d })),
             initial: Math.max(DATABASE_CHOICES.indexOf(scanned?.database || 'none'), 0)
         },
-        { type: assumeYes ? null : 'confirm', name: 'uses_docker', message: 'Uses Docker / Docker Compose?', initial: scanned?.uses_docker ?? true },
+        { type: assumeYes || !reviewScannedFields ? null : 'confirm', name: 'uses_docker', message: 'Uses Docker / Docker Compose?', initial: scanned?.uses_docker ?? true },
         {
-            type: assumeYes ? null : 'select', name: 'cloud', message: 'Cloud Provider:',
+            type: assumeYes || !reviewScannedFields ? null : 'select', name: 'cloud', message: 'Cloud Provider:',
             choices: CLOUD_CHOICES.map(c => ({ title: c, value: c })),
             initial: Math.max(CLOUD_CHOICES.indexOf(scanned?.cloud || 'none'), 0)
         }
@@ -977,12 +1057,12 @@ async function main() {
 
     const { package_manager, test_framework, max_file_lines } = await askQuestions([
         {
-            type: assumeYes ? null : 'select', name: 'package_manager', message: 'Package Manager:',
+            type: assumeYes || !reviewScannedFields ? null : 'select', name: 'package_manager', message: 'Package Manager:',
             choices: PACKAGE_MANAGER_CHOICES.map(p => ({ title: p, value: p })),
             initial: Math.max(PACKAGE_MANAGER_CHOICES.indexOf(scanned?.package_manager || 'auto-detect'), 0)
         },
-        { type: assumeYes ? null : 'text', name: 'test_framework', message: 'Test Framework (jest, phpunit, etc):', initial: scanned?.test_framework || 'auto-detect' },
-        { type: assumeYes ? null : 'text', name: 'max_file_lines', message: 'Max lines per file:', initial: scanned?.max_file_lines || '300' }
+        { type: assumeYes || !reviewScannedFields ? null : 'text', name: 'test_framework', message: 'Test Framework (jest, phpunit, etc):', initial: scanned?.test_framework || 'auto-detect' },
+        { type: assumeYes || !reviewScannedFields ? null : 'text', name: 'max_file_lines', message: 'Max lines per file:', initial: scanned?.max_file_lines || '300' }
     ]);
 
     // Combine data
@@ -1037,9 +1117,26 @@ async function main() {
     const claudeMdPath = path.join(targetDir, 'CLAUDE.md');
     fs.writeFileSync(claudeMdPath, generateClaudeMd(data), 'utf8');
     console.log(`  ${pc.green('✓')} Generated ${pc.bold('CLAUDE.md')}`);
-
-    // Summary
-    const autoSkills = resolveSkills(data);
+
+    if (!assumeYes) {
+        const aiRefineAnswer = await askQuestions({
+            type: 'confirm',
+            name: 'ai_refine',
+            message: 'Do you want an AI refinement prompt for PROJECT_CONTEXT.md?',
+            initial: useScan
+        });
+        requestAiRefinement = Boolean(aiRefineAnswer.ai_refine);
+    }
+
+    let aiRefinementPath = null;
+    if (requestAiRefinement) {
+        aiRefinementPath = path.join(targetDir, 'AI_CONTEXT_REFINEMENT.md');
+        fs.writeFileSync(aiRefinementPath, generateAiContextRefinementPrompt(data), 'utf8');
+        console.log(`  ${pc.green('✓')} Generated ${pc.bold('AI_CONTEXT_REFINEMENT.md')}`);
+    }
+
+    // Summary
+    const autoSkills = resolveSkills(data);
     console.log(`\n${pc.bold(pc.green('━━ Done! ━━'))}
   
   ${pc.bold('Project:')} ${data.project_name}
@@ -1052,11 +1149,12 @@ ${autoSkills.map(s => '    · ' + s).join('\n')}
   ${pc.bold('Generated files:')}
     · ${pc.bold(projectContextPath)}
     · ${pc.bold(claudeMdPath)}
+${aiRefinementPath ? `    · ${pc.bold(aiRefinementPath)}` : ''}
 
   ${pc.bold('Next steps:')}
     1. Your kit is installed in ${pc.bold('./.agent')}
     2. Review ${pc.bold('PROJECT_CONTEXT.md')} first and add architecture notes
-    3. Instruct the agent to read/update ${pc.bold('PROJECT_CONTEXT.md')} before major tasks
+    3. ${aiRefinementPath ? `Open ${pc.bold('AI_CONTEXT_REFINEMENT.md')} in your AI editor to refine project context` : `Instruct the agent to read/update ${pc.bold('PROJECT_CONTEXT.md')} before major tasks`}
     4. Open project in Antigravity or Claude Code — the agent will read context on start
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "thachvd-kit",
-    "version": "1.0.5",
+    "version": "1.0.7",
     "description": "Universal Agent Kit for Antigravity, Claude Code, and OpenCode",
     "bin": {
         "thachvd-kit": "./bin/cli.js"

package/scripts/init.py

@@ -607,7 +607,7 @@ Based on your stack, these skills will be loaded automatically:
 {data.get('known_issues', '<!-- Add known issues or pending tasks -->')}
 """
 
-def generate_claude_md(data):
+def generate_claude_md(data):
     """Generate CLAUDE.md for Claude Code / Codex compatibility."""
     return f"""# CLAUDE.md — {data['project_name']}
 # Generated by thachvd-kit. See PROJECT_CONTEXT.md for full stack info.
@@ -636,8 +636,69 @@ Stack: {data['primary_language']} | {', '.join(data.get('frameworks', []))}
 - `/test` — Run test suite
 - `/deploy` — Deploy checklist
 
-See PROJECT_CONTEXT.md for full agent routing table.
-"""
+See PROJECT_CONTEXT.md for full agent routing table.
+"""
+
+def generate_ai_context_refinement_prompt(data):
+    scan_evidence = data.get("scan_evidence", [])
+    evidence_block = "\n".join("- " + line for line in scan_evidence) if scan_evidence else "- No scan evidence was captured during init."
+    return f"""# AI Context Refinement
+
+Use this prompt in your AI editor after `thachvd-kit init`.
+
+## Goal
+
+Refine `PROJECT_CONTEXT.md` so it reflects the real project more accurately than the baseline init scan.
+
+## Current Baseline
+
+- Project: {data['project_name']}
+- Type: {data['project_type']}
+- Stack: {data['primary_language']} | {', '.join(data.get('frameworks', [])) or 'no framework'}
+- Database: {data.get('database', 'none')}
+- Infra: {', '.join(data.get('infrastructure', [])) or 'none'}
+
+## Scan Evidence
+
+{evidence_block}
+
+## Instructions For The AI Agent
+
+1. Read `PROJECT_CONTEXT.md` first.
+2. Inspect the project selectively to improve factual accuracy.
+3. Prioritize:
+   - real database/config detection
+   - domain/capability inference
+   - architecture notes
+   - more accurate auto-resolved skills
+   - important project-specific constraints
+4. Update `PROJECT_CONTEXT.md` directly.
+5. Distinguish facts from inferences when uncertain.
+6. Do not implement product code in this pass. Only refine project context.
+
+## Suggested Files To Inspect
+
+- Root manifests: `package.json`, `composer.json`, `Cargo.toml`, `pyproject.toml`
+- Infrastructure/config: Docker, CI, env, framework config files
+- Database config and models
+- Main app entry points, routing, controllers/services
+- README and existing documentation
+
+## Desired Improvements
+
+- Correct the `database` field if config files reveal the real DB.
+- Add architecture notes that explain the actual structure.
+- Infer domain capabilities such as scraping, browser automation, external API integrations, queues, workers, etc.
+- Expand auto-resolved skills when there is clear evidence in the codebase.
+- Add caveats or assumptions if parts of the stack are still uncertain.
+
+## Completion Standard
+
+When done, summarize:
+- what was corrected
+- what is still inferred
+- which files provided the strongest evidence
+"""
 
 # ─── Main wizard ─────────────────────────────────────────────────────────────
 
@@ -675,6 +736,7 @@ def main():
             use_scan = existing_mode == "scan"
 
     scanned = scan_project() if use_scan else None
+    review_scanned_fields = not use_scan
     if use_scan:
         print(f"  {dim('Scan mode: detecting stack from current project files...')}")
         print(f"  {bold('Scan result:')} {scanned['primary_language']} | {', '.join(scanned['frameworks']) or 'no framework'}")
@@ -684,6 +746,10 @@ def main():
             for line in scanned["scan_evidence"]:
                 print(f"    · {line}")
             print()
+        if not args.yes:
+            scan_action = ask_select("Use detected context as-is or review fields manually",
+                ["accept", "review"], default="accept")
+            review_scanned_fields = scan_action == "review"
     elif not args.yes:
         print(f"  {dim('Manual mode: asking for project context explicitly.')}\n")
 
@@ -692,7 +758,7 @@ def main():
     else:
         data = {}
 
-    if not args.yes:
+    if not args.yes and review_scanned_fields:
         # ── Project Info ──────────────────────────────────────────────────────
         section("Project Info")
         data["project_name"] = ask("Project name", default=(scanned or {}).get("project_name", Path.cwd().name))
@@ -783,11 +849,17 @@ def main():
     # CLAUDE.md (for Claude Code / Codex)
     if args.platform in ("claude", "all"):
         claude_path = Path("CLAUDE.md")
-        claude_path.write_text(generate_claude_md(data), encoding="utf-8")
-        print(f"  {green('✓')} {bold('CLAUDE.md')} generated (Claude Code / Codex)")
-
-    # Summary
-    auto_skills = resolve_skills(data)
+        claude_path.write_text(generate_claude_md(data), encoding="utf-8")
+        print(f"  {green('✓')} {bold('CLAUDE.md')} generated (Claude Code / Codex)")
+
+    ai_refine_path = None
+    if not args.yes and ask_bool("Generate AI context refinement prompt?", default=use_scan):
+        ai_refine_path = Path("AI_CONTEXT_REFINEMENT.md")
+        ai_refine_path.write_text(generate_ai_context_refinement_prompt(data), encoding="utf-8")
+        print(f"  {green('✓')} {bold('AI_CONTEXT_REFINEMENT.md')} generated")
+
+    # Summary
+    auto_skills = resolve_skills(data)
     print(f"""
 {bold(green('━━ Done! ━━'))}
 
@@ -801,10 +873,11 @@ def main():
   {bold('Generated files:')}
     · {bold(str(output_path.resolve()))}
     · {bold(str(Path("CLAUDE.md").resolve())) if args.platform in ("claude", "all") else 'CLAUDE.md not generated for this platform'}
+    · {bold(str(ai_refine_path.resolve())) if ai_refine_path else 'AI_CONTEXT_REFINEMENT.md not generated'}
 
   {bold('Next steps:')}
     1. Review {bold('PROJECT_CONTEXT.md')} first and add architecture notes
-    2. Instruct the agent to read/update {bold('PROJECT_CONTEXT.md')} before major tasks
+    2. {"Open " + bold("AI_CONTEXT_REFINEMENT.md") + " in your AI editor to refine project context" if ai_refine_path else "Instruct the agent to read/update " + bold("PROJECT_CONTEXT.md") + " before major tasks"}
     3. Open project in your AI editor (Antigravity / Claude Code / Codex)
     4. The agent will read PROJECT_CONTEXT.md on session start