vibe-state-cli 0.1.0__tar.gz

vibe_state_cli-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# Environment
+.env
+.env.local
+
+# Distribution
+*.whl
+*.tar.gz
+
+# vibe-state-cli development
+# Keep .vibe/ tracked for dogfooding, but ignore backups/snapshots
+.vibe/backups/
+.vibe/snapshots/

vibe_state_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2026 vibe-state-cli contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vibe_state_cli-0.1.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: vibe-state-cli
+Version: 0.1.0
+Summary: Model-agnostic AI-human collaboration state management CLI
+Project-URL: Homepage, https://github.com/vibe-state-cli/vibe-state-cli
+Project-URL: Documentation, https://vibe-state-cli.github.io/
+Project-URL: Repository, https://github.com/vibe-state-cli/vibe-state-cli
+Project-URL: Issues, https://github.com/vibe-state-cli/vibe-state-cli/issues
+Author: vibe-state-cli contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cli,developer-tools,state-management,vibe
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: markdown-it-py>=3.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.27.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# vibe-state-cli
+
+[English](README.md) | [繁體中文](docs/zh-TW/README.md)
+
+**Model-agnostic AI-human collaboration state management CLI.**
+
+Let any AI model — Claude, GPT, Gemini, or local models — instantly sync with your project's context by reading a single `.vibe/` directory.
+
+## Why vibe?
+
+| Problem | How vibe solves it |
+|---------|-------------------|
+| AI loses memory every session | `.vibe/state/` persists across sessions and tools |
+| Switching AI tools = starting over | 8 adapters generate each tool's native config from one source |
+| CLAUDE.md grows forever, wastes tokens | `vibe sync --compact` auto-archives, keeps state lean (~684 tokens) |
+| Manual copy-paste of context prompts | `vibe init` scans your project and generates everything |
+| No structured handoff between sessions | `vibe sync` appends git state + C.L.E.A.R. review checklist |
+
+Works **100% offline**. No API keys, no telemetry, no network calls.
+
+## Install
+
+```bash
+pipx install vibe-state-cli
+```
+
+## Quick Start
+
+```bash
+cd my-project
+
+vibe init                # Initialize .vibe/ (auto-detects language, framework, AI tools)
+vibe start               # Daily start — load state, git check, auto-compact
+vibe sync                # Daily close — append git status, C.L.E.A.R. review
+vibe sync --compact      # Archive completed tasks, compress state files
+vibe sync --close        # End project — final sync + retrospective
+vibe status              # Check project state (anytime)
+vibe adapt --list        # See which AI tool adapters are enabled
+```
+
+## 5 Commands
+
+| Command | When | What it does |
+|---------|------|-------------|
+| `vibe init` | Once | Scan project, generate `.vibe/`, detect AI tools, emit adapter files |
+| `vibe start` | Daily | Load state, validate vs git, auto-compact if needed, Rich summary |
+| `vibe sync` | Daily | Append git status to state, C.L.E.A.R. checklist |
+| `vibe status` | Anytime | Show lifecycle, tasks, file sizes |
+| `vibe adapt` | As needed | `--add`/`--remove`/`--list`/`--sync` adapter files |
+
+### Flags
+
+- `vibe init --lang zh-TW` — Traditional Chinese templates
+- `vibe init --force` — Reinitialize or reopen a closed project
+- `vibe sync --compact` — Run memory compaction after sync
+- `vibe sync --close` — Close project with retrospective
+- `vibe adapt --remove cursor --dry-run` — Preview before deleting
+- `vibe adapt --remove cursor --confirm` — Delete with backup
+
+## Supported AI Tools
+
+| Tool | Generated Config | Auto-detected by |
+|------|-----------------|------------------|
+| AGENTS.md | `AGENTS.md` | `AGENTS.md` exists |
+| Claude Code | `CLAUDE.md` + `.claude/rules/` | `.claude/` directory |
+| Antigravity / Gemini | `GEMINI.md` | `GEMINI.md` or `.gemini/` |
+| Cursor | `.cursor/rules/*.mdc` | `.cursor/` directory |
+| GitHub Copilot | `.github/copilot-instructions.md` | existing copilot config |
+| Windsurf | `.windsurf/rules/*.md` | `.windsurf/` directory |
+| Cline | `.clinerules/*.md` | `.clinerules/` directory |
+| Roo Code | `.roo/rules/*.md` | `.roo/` directory |
+
+Only detected tools get adapter files generated. No bloat.
+
+## Autoresearch Integration
+
+Supports [autoresearch](https://github.com/uditgoenka/autoresearch) experiment loops. `vibe sync` auto-detects experiment commits and records results to `state/experiments.md`.
+
+## Safety
+
+- `vibe adapt --remove` defaults to **dry-run** — requires `--confirm` to delete
+- Snapshots saved on every emit for diff detection
+- Backups kept (last 3) before any deletion
+- User-modified files trigger warnings before overwrite
+
+## License
+
+MIT

vibe_state_cli-0.1.0/README.md

@@ -0,0 +1,88 @@
+# vibe-state-cli
+
+[English](README.md) | [繁體中文](docs/zh-TW/README.md)
+
+**Model-agnostic AI-human collaboration state management CLI.**
+
+Let any AI model — Claude, GPT, Gemini, or local models — instantly sync with your project's context by reading a single `.vibe/` directory.
+
+## Why vibe?
+
+| Problem | How vibe solves it |
+|---------|-------------------|
+| AI loses memory every session | `.vibe/state/` persists across sessions and tools |
+| Switching AI tools = starting over | 8 adapters generate each tool's native config from one source |
+| CLAUDE.md grows forever, wastes tokens | `vibe sync --compact` auto-archives, keeps state lean (~684 tokens) |
+| Manual copy-paste of context prompts | `vibe init` scans your project and generates everything |
+| No structured handoff between sessions | `vibe sync` appends git state + C.L.E.A.R. review checklist |
+
+Works **100% offline**. No API keys, no telemetry, no network calls.
+
+## Install
+
+```bash
+pipx install vibe-state-cli
+```
+
+## Quick Start
+
+```bash
+cd my-project
+
+vibe init                # Initialize .vibe/ (auto-detects language, framework, AI tools)
+vibe start               # Daily start — load state, git check, auto-compact
+vibe sync                # Daily close — append git status, C.L.E.A.R. review
+vibe sync --compact      # Archive completed tasks, compress state files
+vibe sync --close        # End project — final sync + retrospective
+vibe status              # Check project state (anytime)
+vibe adapt --list        # See which AI tool adapters are enabled
+```
+
+## 5 Commands
+
+| Command | When | What it does |
+|---------|------|-------------|
+| `vibe init` | Once | Scan project, generate `.vibe/`, detect AI tools, emit adapter files |
+| `vibe start` | Daily | Load state, validate vs git, auto-compact if needed, Rich summary |
+| `vibe sync` | Daily | Append git status to state, C.L.E.A.R. checklist |
+| `vibe status` | Anytime | Show lifecycle, tasks, file sizes |
+| `vibe adapt` | As needed | `--add`/`--remove`/`--list`/`--sync` adapter files |
+
+### Flags
+
+- `vibe init --lang zh-TW` — Traditional Chinese templates
+- `vibe init --force` — Reinitialize or reopen a closed project
+- `vibe sync --compact` — Run memory compaction after sync
+- `vibe sync --close` — Close project with retrospective
+- `vibe adapt --remove cursor --dry-run` — Preview before deleting
+- `vibe adapt --remove cursor --confirm` — Delete with backup
+
+## Supported AI Tools
+
+| Tool | Generated Config | Auto-detected by |
+|------|-----------------|------------------|
+| AGENTS.md | `AGENTS.md` | `AGENTS.md` exists |
+| Claude Code | `CLAUDE.md` + `.claude/rules/` | `.claude/` directory |
+| Antigravity / Gemini | `GEMINI.md` | `GEMINI.md` or `.gemini/` |
+| Cursor | `.cursor/rules/*.mdc` | `.cursor/` directory |
+| GitHub Copilot | `.github/copilot-instructions.md` | existing copilot config |
+| Windsurf | `.windsurf/rules/*.md` | `.windsurf/` directory |
+| Cline | `.clinerules/*.md` | `.clinerules/` directory |
+| Roo Code | `.roo/rules/*.md` | `.roo/` directory |
+
+Only detected tools get adapter files generated. No bloat.
+
+## Autoresearch Integration
+
+Supports [autoresearch](https://github.com/uditgoenka/autoresearch) experiment loops. `vibe sync` auto-detects experiment commits and records results to `state/experiments.md`.
+
+## Safety
+
+- `vibe adapt --remove` defaults to **dry-run** — requires `--confirm` to delete
+- Snapshots saved on every emit for diff detection
+- Backups kept (last 3) before any deletion
+- User-modified files trigger warnings before overwrite
+
+## License
+
+MIT

vibe_state_cli-0.1.0/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vibe-state-cli"
+version = "0.1.0"
+description = "Model-agnostic AI-human collaboration state management CLI"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "vibe-state-cli contributors" },
+]
+keywords = ["ai", "cli", "state-management", "developer-tools", "vibe"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "jinja2>=3.1.0",
+    "markdown-it-py>=3.0.0",
+    "pydantic>=2.0.0",
+    "tomli>=2.0.0; python_version < '3.11'",
+    "tomli-w>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+    "ruff>=0.4.0",
+    "mypy>=1.10.0",
+    "pre-commit>=3.0.0",
+]
+mcp = [
+    "mcp>=1.27.0",
+]
+
+[project.scripts]
+vibe = "vibe_state.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/vibe-state-cli/vibe-state-cli"
+Documentation = "https://vibe-state-cli.github.io/"
+Repository = "https://github.com/vibe-state-cli/vibe-state-cli"
+Issues = "https://github.com/vibe-state-cli/vibe-state-cli/issues"
+
+[tool.hatch.build.targets.sdist]
+include = ["src/vibe_state"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vibe_state"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short"

vibe_state_cli-0.1.0/src/vibe_state/__init__.py

@@ -0,0 +1,3 @@
+"""vibe-state-cli: Model-agnostic AI-human collaboration state management."""
+
+__version__ = "0.1.0"

vibe_state_cli-0.1.0/src/vibe_state/adapters/agents_md.py

@@ -0,0 +1,39 @@
+"""AGENTS.md adapter — Linux Foundation / AAIF universal standard."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from vibe_state.adapters.base import AdapterBase, AdapterContext
+from vibe_state.adapters.registry import register_adapter
+
+MAX_SIZE_BYTES = 32 * 1024
+
+
+@register_adapter
+class AgentsMdAdapter(AdapterBase):
+    name = "agents_md"
+    REQUIRED_FIELDS: set[str] = set()
+
+    def detect(self, project_root: Path) -> bool:
+        return (project_root / "AGENTS.md").exists()
+
+    def emit(self, ctx: AdapterContext) -> list[Path]:
+        lines = [
+            f"# AGENTS.md — {ctx.project_name}",
+            "",
+            "## Project",
+            "",
+        ]
+        lines += self._build_common_body(ctx)
+        content = "\n".join(lines)
+        if not self.validate(content):
+            self._warn_validation("AGENTS.md (>32KiB)")
+        return [self._write_file(ctx.project_root / "AGENTS.md", content)]
+
+    def clean(self, project_root: Path) -> list[Path]:
+        p = project_root / "AGENTS.md"
+        return [p] if p.exists() else []
+
+    def validate(self, output: str) -> bool:
+        return len(output.encode("utf-8")) <= MAX_SIZE_BYTES

vibe_state_cli-0.1.0/src/vibe_state/adapters/antigravity.py

@@ -0,0 +1,49 @@
+"""Antigravity / Gemini CLI adapter — GEMINI.md (plain Markdown, no frontmatter)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from vibe_state.adapters.base import AdapterBase, AdapterContext
+from vibe_state.adapters.registry import register_adapter
+
+
+@register_adapter
+class AntigravityAdapter(AdapterBase):
+    name = "antigravity"
+    REQUIRED_FIELDS: set[str] = set()  # No frontmatter for GEMINI.md
+
+    def detect(self, project_root: Path) -> bool:
+        return (project_root / "GEMINI.md").exists()
+
+    def emit(self, ctx: AdapterContext) -> list[Path]:
+        lines = [f"# GEMINI.md — {ctx.project_name}", ""]
+
+        if "agents_md" in ctx.enabled_adapters:
+            # Import AGENTS.md to avoid duplication (same pattern as Claude adapter)
+            lines += [
+                "@AGENTS.md",
+                "",
+                "## Antigravity-Specific",
+                "",
+            ]
+        else:
+            # Self-contained: include full project info
+            lines += ["## Project", ""]
+            lines += self._build_common_body(ctx)
+
+        lines += [
+            "## Vibe Workflow",
+            "",
+            "Read `.vibe/VIBE.md` for the full protocol.",
+            "**Checkpoint**: After each task, mark `[x]` in `state/tasks.md`"
+            " and append to `state/current.md`.",
+            "**Reality-First**: When memory conflicts with git, trust git.",
+            "",
+        ]
+        content = "\n".join(lines)
+        return [self._write_file(ctx.project_root / "GEMINI.md", content)]
+
+    def clean(self, project_root: Path) -> list[Path]:
+        p = project_root / "GEMINI.md"
+        return [p] if p.exists() else []

vibe_state_cli-0.1.0/src/vibe_state/adapters/base.py

@@ -0,0 +1,201 @@
+"""Base adapter interface for all AI/IDE tool adapters."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from pathlib import Path
+
+
+@dataclass
+class AdapterContext:
+    """Context passed to adapters for file generation."""
+
+    project_root: Path
+    vibe_dir: Path
+    constitution: str  # VIBE.md content
+    standards: str  # state/standards.md content
+    architecture: str  # state/architecture.md content
+    languages: list[str] = field(default_factory=list)
+    frameworks: list[str] = field(default_factory=list)
+    project_name: str = ""
+    enabled_adapters: list[str] = field(default_factory=list)
+
+
+def _sanitize(value: str) -> str:
+    """Strip newlines, #, quotes, and control chars from user-controlled strings."""
+    return "".join(c for c in value if c.isprintable() and c not in '\n\r#"\'`')
+
+
+# Patterns that indicate malicious injection in standards/state files
+_SUSPICIOUS_PATTERNS = [
+    "eval(",
+    "exec(",
+    "system(",
+    "import os",
+    "import subprocess",
+    "__import__",
+    "curl ",
+    "wget ",
+    "rm -rf",
+    "ignore all",
+    "ignore previous",
+    "disregard",
+    "override all",
+    "new rule",
+    "send all",
+    "exfiltrate",
+    "http://",
+    "https://",
+]
+
+
+def _is_suspicious_instruction(text: str) -> bool:
+    """Detect potentially malicious instructions in state file content."""
+    lower = text.lower()
+    return any(pattern in lower for pattern in _SUSPICIOUS_PATTERNS)
+
+
+def build_adapter_context(project_root: Path) -> AdapterContext:
+    """Build AdapterContext from .vibe/ config + state files."""
+    vibe_dir = project_root / ".vibe"
+
+    def _read(rel: str) -> str:
+        p = vibe_dir / rel
+        return p.read_text(encoding="utf-8") if p.exists() else ""
+
+    from vibe_state.config import load_config
+
+    config = load_config(vibe_dir)
+
+    # Parse languages/frameworks from architecture.md
+    languages: list[str] = []
+    frameworks: list[str] = []
+    arch = _read("state/architecture.md")
+    for line in arch.splitlines():
+        if line.strip().startswith("- Language:"):
+            lang_val = line.split(":", 1)[1].strip()
+            if lang_val:
+                languages.append(lang_val)
+        if line.strip().startswith("- Framework:"):
+            fw_val = line.split(":", 1)[1].strip()
+            if fw_val:
+                frameworks.append(fw_val)
+
+    return AdapterContext(
+        project_root=project_root,
+        vibe_dir=vibe_dir,
+        constitution=_read("VIBE.md"),
+        standards=_read("state/standards.md"),
+        architecture=_read("state/architecture.md"),
+        languages=[_sanitize(lang) for lang in languages],
+        frameworks=[_sanitize(fw) for fw in frameworks],
+        project_name=_sanitize(project_root.name),
+        enabled_adapters=config.adapters.enabled,
+    )
+
+
+class AdapterBase(ABC):
+    """Abstract base class for all adapters."""
+
+    name: str = ""
+    REQUIRED_FIELDS: set[str] = set()
+
+    @abstractmethod
+    def detect(self, project_root: Path) -> bool:
+        """Detect if this tool's config already exists in the project."""
+
+    @abstractmethod
+    def emit(self, ctx: AdapterContext) -> list[Path]:
+        """Generate config files for this tool. Returns list of created file paths."""
+
+    @abstractmethod
+    def clean(self, project_root: Path) -> list[Path]:
+        """Return list of files that would be removed for this adapter."""
+
+    def validate(self, output: str) -> bool:
+        """Validate emitted file content. Override for frontmatter checks."""
+        return True
+
+    def _write_file(self, path: Path, content: str) -> Path:
+        """Write content to file with integrity marker (markdown only)."""
+        import hashlib
+
+        path.parent.mkdir(parents=True, exist_ok=True)
+        # Add integrity marker only to markdown files (not JSON, TOML, etc.)
+        if path.suffix in (".md", ".mdc"):
+            content_hash = hashlib.sha256(content.encode("utf-8")).hexdigest()[:12]
+            content = content.rstrip() + f"\n\n<!-- vibe-state-cli:integrity:{content_hash} -->\n"
+        path.write_text(content, encoding="utf-8", newline="\n")
+        return path
+
+    def _build_common_body(
+        self, ctx: AdapterContext, *, slim: bool = False
+    ) -> list[str]:
+        """Build the common project info + standards + security block.
+
+        Args:
+            slim: If True, emit only the session-start directive (for when
+                  AGENTS.md is also enabled and already carries the full body).
+        """
+        lines: list[str] = []
+
+        if slim:
+            # Minimal: just point to AGENTS.md and .vibe/ for details
+            lines += [
+                "See AGENTS.md for project standards and security rules.",
+                "",
+            ]
+        else:
+            if ctx.languages:
+                lines.append(f"- Languages: {', '.join(ctx.languages)}")
+            if ctx.frameworks:
+                lines.append(f"- Frameworks: {', '.join(ctx.frameworks)}")
+            lines.append("")
+
+            # Pull standards with injection detection
+            has_security = False
+            if ctx.standards:
+                for line in ctx.standards.splitlines():
+                    stripped = line.strip()
+                    if stripped.startswith("- ") and not stripped.startswith("- ("):
+                        # Block suspicious instructions from propagating
+                        lower = stripped.lower()
+                        if _is_suspicious_instruction(lower):
+                            continue
+                        lines.append(_sanitize(stripped))
+                        if "hardcode" in lower or "secret" in lower:
+                            has_security = True
+                lines.append("")
+
+            # Only add security block if standards didn't already include it
+            if not has_security:
+                lines += [
+                    "## Security",
+                    "- Never hardcode secrets, tokens, or passwords",
+                    "- Use .env files for environment variables",
+                    "",
+                ]
+
+        # Always include: session-start directive + boundaries
+        lines += [
+            "## Session Start — READ THESE FILES",
+            "At the beginning of every session, read these files for project context:",
+            "- `.vibe/state/current.md` — latest progress and sync history",
+            "- `.vibe/state/tasks.md` — active task checklist",
+            "- `.vibe/VIBE.md` — project constitution and workflow SOP",
+            "",
+            "## Boundaries",
+            "- Do NOT modify `.vibe/config.toml` or `.vibe/state/.lifecycle` directly",
+            "- Do NOT run destructive commands without human confirmation",
+            "",
+        ]
+        return lines
+
+    def _warn_validation(self, adapter_name: str) -> None:
+        """Print a validation warning."""
+        from rich.console import Console
+
+        Console().print(
+            f"[yellow]Warning:[/] {adapter_name} frontmatter validation failed"
+        )