adelie-ai 0.2.5 → 0.2.6

package/adelie/agents/expert_ai.py

@@ -88,6 +88,80 @@ def _get_recent_build_errors() -> str:
     return content[:500]  # 토큰 제한
 
 
+def _get_project_file_snapshot() -> str:
+    """
+    Scan the actual project directory and return a reality summary.
+    This gives Expert AI ground-truth about what code actually exists,
+    preventing premature EXPORT/PAUSE when no source code is present.
+    """
+    from adelie.config import PROJECT_ROOT
+
+    if not PROJECT_ROOT.exists():
+        return "Project directory not found."
+
+    SOURCE_EXTS = {".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs", ".java", ".kt", ".swift", ".vue", ".svelte"}
+    CONFIG_EXTS = {".json", ".toml", ".yaml", ".yml", ".env", ".cfg", ".ini"}
+    SKIP_DIRS = {"node_modules", "__pycache__", ".git", ".adelie", "dist", "build", ".venv", "venv"}
+
+    source_files: list[str] = []
+    config_files: list[str] = []
+    total_lines = 0
+
+    for path in PROJECT_ROOT.rglob("*"):
+        if path.is_file():
+            # Skip hidden/build dirs
+            parts = set(path.parts)
+            if parts & SKIP_DIRS:
+                continue
+            rel = str(path.relative_to(PROJECT_ROOT))
+            if path.suffix in SOURCE_EXTS:
+                source_files.append(rel)
+                try:
+                    total_lines += len(path.read_text(encoding="utf-8", errors="ignore").splitlines())
+                except Exception:
+                    pass
+            elif path.suffix in CONFIG_EXTS:
+                config_files.append(rel)
+
+    src_count = len(source_files)
+    cfg_count = len(config_files)
+
+    # Determine deployment readiness contextually
+    if src_count == 0:
+        readiness = "❌ NO SOURCE CODE — implementation has not started"
+        advice = (
+            "IMPORTANT CONTEXT: There are no source files in the project yet. "
+            "EXPORT or PAUSE at this stage provides zero value to the user. "
+            "The highest priority is to create coder_tasks to build the actual application."
+        )
+    elif src_count < 5:
+        readiness = f"⚠️ EARLY STAGE — only {src_count} source file(s), scaffolding phase"
+        advice = (
+            "The project is in early scaffolding. "
+            "Prioritize coder_tasks to build core features before any documentation exports."
+        )
+    elif total_lines < 200:
+        readiness = f"🔶 SKELETON — {src_count} files but only {total_lines} total lines"
+        advice = "Source files exist but content is minimal. Focus on implementation over exports."
+    else:
+        readiness = f"✅ CODE EXISTS — {src_count} source file(s), {total_lines:,} lines"
+        advice = "Source code is present. Documentation and exports are appropriate."
+
+    # Show up to 10 source files
+    sample = source_files[:10]
+    sample_str = "\n  ".join(sample) if sample else "(none)"
+    if len(source_files) > 10:
+        sample_str += f"\n  ... and {len(source_files) - 10} more"
+
+    return f"""## Current Project Reality (File System Snapshot)
+Status: {readiness}
+Source files: {src_count}  |  Config files: {cfg_count}  |  Total lines: {total_lines:,}
+
+Source files found:
+  {sample_str}
+
+{advice}"""
+
 def _get_scaffolding_need() -> str:
     """
     프로젝트 진입 파일 존재 여부 검사.
@@ -347,6 +421,9 @@ Total KB files across all categories: {total_kb_files}
 ## ⚠️ Missing Project Entry Files (CREATE THESE FIRST)
 {_get_scaffolding_need()}
 
+{_get_project_file_snapshot()}
+
+
 ## This Cycle — Writer AI Output
 {writer_summary}
 {get_context_prompt_section()}{get_rules_prompt_section()}{get_skills_prompt_section("expert")}{get_tool_registry().get_tools_prompt("expert")}

package/adelie/agents/writer_ai.py

@@ -15,7 +15,7 @@ from pathlib import Path
 
 from rich.console import Console
 
-from adelie.config import WORKSPACE_PATH, KB_CATEGORIES
+from adelie.config import WORKSPACE_PATH, KB_CATEGORIES, PROJECT_ROOT
 from adelie.context_compactor import (
     compact_system_state,
     compact_expert_output,
@@ -28,6 +28,45 @@ from adelie.phases import get_phase_prompt
 console = Console()
 
 
+def _get_project_file_snapshot_for_writer() -> str:
+    """
+    Provide Writer AI with scope guidance based on actual project files.
+    Prevents writing deployment/security docs before code exists.
+    """
+    if not PROJECT_ROOT.exists():
+        return ""
+
+    SOURCE_EXTS = {".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs", ".java", ".kt", ".vue", ".svelte"}
+    SKIP_DIRS = {"node_modules", "__pycache__", ".git", ".adelie", "dist", "build", ".venv", "venv"}
+
+    source_files = [
+        p for p in PROJECT_ROOT.rglob("*")
+        if p.is_file()
+        and p.suffix in SOURCE_EXTS
+        and not (set(p.parts) & SKIP_DIRS)
+    ]
+    src_count = len(source_files)
+
+    if src_count == 0:
+        return (
+            "⚠️ WRITER SCOPE: No source code exists yet in this project.\n"
+            "- DO NOT write deployment guides, security audits, or CI/CD pipelines.\n"
+            "  Those are premature when there is no code to deploy.\n"
+            "- Instead write: architecture plans, tech stack decisions, implementation\n"
+            "  roadmaps, and component design documents.\n"
+            "- Spec files describe FUTURE goals, not current reality."
+        )
+    elif src_count < 5:
+        return (
+            f"⚠️ WRITER SCOPE: Only {src_count} source file(s) exist (early scaffolding).\n"
+            "- Focus on implementation guides, coding patterns, and API specs.\n"
+            "- Deployment/security docs are premature at this stage.\n"
+            "- Prioritize writing content that helps the Coder AI build features."
+        )
+    else:
+        return f"✅ WRITER SCOPE: {src_count} source files found — all documentation types are appropriate."
+
+
 def _list_existing_files() -> str:
     """Build a summary of all existing KB files per category for the Writer AI prompt."""
     lines = []
@@ -140,6 +179,9 @@ def run(
 - Focus on creating files that cover DIFFERENT topics than what already exists.
 - If the KB already has planning docs, create implementation/technical docs instead.
 
+## SCOPE GUIDANCE — Read Before Writing
+{_get_project_file_snapshot_for_writer()}
+
 Based on the above context, what knowledge files should be created or updated?
 Do NOT recreate files with roughly the same content as existing ones.
 Remember: output ONLY a valid JSON array.

package/adelie/phases.py

@@ -57,7 +57,7 @@ Your decision criteria in this phase:
 - Check if these KB files exist: project_vision, architecture, roadmap
 - If any are missing, request them via kb_updates_needed""",
 
-        "transition_criteria": "Transition to MID when: roadmap.md exists, architecture is documented, and at least 5 KB files exist.",
+        "transition_criteria": "Transition to MID when: roadmap.md exists, architecture is documented, at least 5 KB files exist, AND at least one coder_task has been issued (even scaffolding).",
     },
 
     Phase.MID: {
@@ -160,13 +160,18 @@ Priority files:
         "expert_directive": """PHASE: MID_2 (중기 2기)
 Your decision criteria in this phase:
 - Prioritize STABILITY and OPTIMIZATION
-- Request deployment documentation
-- Check that security and performance are addressed
-- Use EXPORT for deployment-ready artifacts
-- Focus on business viability documentation
-- Suggest PAUSE for careful review before major deployments""",
-
-        "transition_criteria": "Transition to LATE when: deployed, stable, monetization strategy documented.",
+- CRITICAL: Check the 'Current Project Reality' section for actual file counts.
+  * If source_files = 0: treat this as MID phase — create coder_tasks to build the app.
+    EXPORT and PAUSE when no code exists is meaningless.
+  * If source_files < 5: prioritize coder_tasks to complete core implementation first.
+  * If source_files >= 5 and total_lines > 500: then documentation/deployment exports are appropriate.
+- Request deployment documentation only AFTER code exists
+- Check that security and performance are addressed in the codebase
+- Use EXPORT for deployment-ready artifacts — only when the project actually has code
+- Focus on business viability documentation only after implementation is underway
+- Suggest PAUSE for careful review before major deployments (not before code exists)""",
+
+        "transition_criteria": "Transition to LATE when: source code exists (>5 files), deployed, stable, monetization strategy documented.",
     },
 
     Phase.LATE: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adelie-ai",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Adelie — Self-Communicating Autonomous AI Loop CLI",
   "bin": {
     "adelie": "bin/adelie.js"