fgeo 0.1.0__py3-none-any.whl

fgeo/__init__.py

@@ -0,0 +1,8 @@
+"""fgeo — Generative Engine Optimization CLI."""
+
+from __future__ import annotations
+
+try:
+    from fgeo._version import version as __version__
+except Exception:  # pragma: no cover - source tree fallback before build metadata exists
+    __version__ = "0.0.0"

fgeo/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running fgeo as: python -m fgeo"""
+
+from fgeo.cli import app
+
+if __name__ == "__main__":  # pragma: no cover
+    app()

fgeo/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = None

fgeo/cli.py

@@ -0,0 +1,70 @@
+"""fgeo CLI — Generative Engine Optimization CLI
+
+AI-powered content asset management and multi-platform distribution.
+"""
+
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+
+from fgeo import __version__
+from fgeo.commands.brand import brand_app
+from fgeo.commands.content import content_app
+from fgeo.commands.project import project_app
+from fgeo.commands.goal import goal_app
+from fgeo.commands.platform import platform_app
+from fgeo.commands.plan import plan_app
+from fgeo.commands.publish import publish_app
+from fgeo.commands.status import status_command
+from fgeo.commands.style import style_app
+from fgeo.commands.enable import SUPPORTED_AGENTS
+
+console = Console()
+
+app = typer.Typer(
+    name="fgeo",
+    help="fgeo — Generative Engine Optimization CLI.\n\nAI-powered content asset management and multi-platform distribution.",
+    no_args_is_help=True,
+    rich_markup_mode="rich",
+)
+
+# Sub-command groups
+app.add_typer(brand_app, name="brand")
+app.add_typer(project_app, name="project")
+app.add_typer(goal_app, name="goal")
+app.add_typer(platform_app, name="platform")
+app.add_typer(plan_app, name="plan")
+app.add_typer(content_app, name="content")
+app.add_typer(publish_app, name="publish")
+app.add_typer(style_app, name="style")
+
+# Top-level commands
+app.command("status")(status_command)
+
+
+@app.command()
+def init() -> None:
+    """Initialize fgeo — create ~/.fgeo global directory with config and database."""
+    from fgeo.commands.init import init as _init
+
+    _init()
+
+
+@app.command()
+def enable(
+    agent: str = typer.Argument(help=f"Agent to enable: {', '.join(SUPPORTED_AGENTS)} (or 'list')"),
+) -> None:
+    """Enable AI agent integration — sets up fcontext + fgeo skill instructions."""
+    from fgeo.commands.enable import enable as _enable
+
+    _enable(agent)
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    version: bool = typer.Option(False, "--version", "-v", help="Show version"),
+) -> None:
+    if version:
+        console.print(f"fgeo {__version__}")
+        raise typer.Exit()

fgeo/commands/brand.py

@@ -0,0 +1,100 @@
+"""fgeo brand — Global author brand profile management."""
+
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+
+from fgeo.database import get_db
+
+console = Console()
+brand_app = typer.Typer(help="Manage global author brand profile (user-level, applies across all projects).")
+
+BRAND_FIELDS = ["name", "positioning", "voice", "core_values", "topics"]
+FIELD_LABELS = {
+    "name":        "Author Name",
+    "positioning": "Positioning",
+    "voice":       "Voice & Tone",
+    "core_values": "Core Values",
+    "topics":      "Topic Domains",
+}
+FIELD_HINTS = {
+    "name":        "e.g. Marvin Ma · MarvinTalk",
+    "positioning": "e.g. 产品技术人 × AI工具链布道者",
+    "voice":       "e.g. 直接、有观点、技术感强、偶尔幽默",
+    "core_values": "e.g. 工具驱动生产力、AI Native、持续输出",
+    "topics":      "e.g. AI工具、GEO/SEO、系统设计、Developer Tools",
+}
+
+
+@brand_app.command("show")
+def show() -> None:
+    """Show current brand profile."""
+    db = get_db()
+    brand = db.get_brand()
+    db.close()
+
+    is_empty = all(not brand.get(f) for f in BRAND_FIELDS)
+
+    if is_empty:
+        console.print(Panel(
+            "[yellow]Brand profile not set up yet.[/yellow]\n\n"
+            "Run [cyan]fgeo brand set <field> <value>[/cyan] to fill in your profile.\n"
+            "Fields: " + ", ".join(BRAND_FIELDS),
+            title="🎨 Brand Profile",
+            border_style="yellow",
+        ))
+        return
+
+    table = Table(title="🎨 Brand Profile", show_header=False, box=None, padding=(0, 2))
+    table.add_column("Field", style="dim", min_width=14)
+    table.add_column("Value", style="bold")
+
+    for field in BRAND_FIELDS:
+        val = brand.get(field, "")
+        label = FIELD_LABELS[field]
+        table.add_row(label, val if val else "[dim](not set)[/dim]")
+
+    console.print(table)
+    if brand.get("updated_at"):
+        console.print(f"  [dim]Last updated: {brand['updated_at'][:19]}[/dim]")
+
+
+@brand_app.command("set")
+def set_field(
+    field: str = typer.Argument(help=f"Field to set: {', '.join(BRAND_FIELDS)}"),
+    value: str = typer.Argument(help="New value"),
+) -> None:
+    """Set a brand profile field."""
+    if field not in BRAND_FIELDS:
+        console.print(f"[red]Unknown field '{field}'. Choose from: {', '.join(BRAND_FIELDS)}[/red]")
+        raise typer.Exit(1)
+
+    db = get_db()
+    result = db.set_brand(field, value)
+    db.close()
+
+    if not result:
+        console.print(f"[red]Failed to set brand field '{field}'.[/red]")
+        raise typer.Exit(1)
+
+    console.print(f"[green]✓[/green] brand.[cyan]{field}[/cyan] → {value}")
+
+
+@brand_app.command("init")
+def init() -> None:
+    """Print brand setup guide for AI-assisted onboarding."""
+    console.print(Panel(
+        "[bold]Brand onboarding guide[/bold]\n\n"
+        "This command is intended to be called by AI agents during onboarding.\n"
+        "The AI should interview the user and then call [cyan]fgeo brand set[/cyan] for each field.\n\n"
+        "[bold]Fields to fill:[/bold]\n"
+        + "\n".join(
+            f"  [cyan]fgeo brand set {f} \"...\"[/cyan]  — {FIELD_HINTS[f]}"
+            for f in BRAND_FIELDS
+        ),
+        title="🎨 Brand Init",
+        border_style="cyan",
+    ))

fgeo/commands/content.py

@@ -0,0 +1,301 @@
+"""fgeo content — Register, list, and manage content assets (v0.2 SQLite)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+
+from fgeo.database import get_db
+
+console = Console()
+content_app = typer.Typer(help="Manage content assets — atomic pieces of platform-native content.")
+
+
+def _extract_frontmatter(path: Path) -> dict:
+    """Extract frontmatter fields from a markdown file."""
+    result: dict = {}
+    try:
+        text = path.read_text(encoding="utf-8")
+        lines = text.split("\n")
+        if lines and lines[0].strip() == "---":
+            for line in lines[1:]:
+                if line.strip() == "---":
+                    break
+                if ":" in line:
+                    key, _, value = line.partition(":")
+                    key = key.strip().lower()
+                    value = value.strip().strip("\"'")
+                    if key == "tags":
+                        value = value.strip("[]")
+                        result[key] = [t.strip().strip("\"'") for t in value.split(",") if t.strip()]
+                    else:
+                        result[key] = value
+        if "title" not in result:
+            for line in lines:
+                if line.startswith("# "):
+                    result["title"] = line[2:].strip()
+                    break
+    except Exception:
+        pass
+    return result
+
+
+@content_app.command("register")
+def register(
+    path: Path = typer.Argument(help="Path to the content file"),
+    title: str = typer.Option("", "--title", "-t", help="Override title"),
+    project: str = typer.Option("", "--project", "-P", help="Project name"),
+    platform: str = typer.Option("", "--platform", help="Platform name"),
+    plan: str = typer.Option("", "--plan", help="Plan name"),
+    direction: str = typer.Option("", "--direction", "-d", help="Content direction"),
+    tags: str = typer.Option("", "--tags", help="Comma-separated tags"),
+    description: str = typer.Option("", "--desc", help="Content description"),
+    content_type: str = typer.Option("", "--type", help="Content type: article, video, slide, thread, short"),
+    status: str = typer.Option("draft", "--status", "-s", help="Initial status: planned, draft, review, published"),
+) -> None:
+    """Register a content file into the fgeo database."""
+    if not path.exists():
+        console.print(f"[red]File not found: {path}[/red]")
+        raise typer.Exit(1)
+
+    path = path.resolve()
+
+    # Extract from frontmatter for markdown files
+    if path.suffix.lower() in (".md", ".markdown", ".mdx"):
+        fm = _extract_frontmatter(path)
+        if not title:
+            title = fm.get("title", "")
+        if not description:
+            description = fm.get("description", "")
+        if not tags:
+            fm_tags = fm.get("tags", [])
+            if isinstance(fm_tags, list):
+                tags = ",".join(fm_tags)
+
+    # Auto-detect content type from extension
+    if not content_type:
+        suffix = path.suffix.lower()
+        if suffix in (".mp4", ".mov", ".avi", ".mkv", ".webm"):
+            content_type = "video"
+        elif suffix in (".pptx", ".key", ".pdf"):
+            content_type = "slide"
+        else:
+            content_type = "article"
+
+    if not title:
+        title = path.stem.replace("-", " ").replace("_", " ").strip()
+
+    db = get_db()
+    entry = db.register_content(
+        source_path=str(path),
+        title=title,
+        project_name=project,
+        platform_name=platform,
+        plan_name=plan,
+        direction=direction,
+        description=description,
+        content_type=content_type,
+        tags=tags,
+        status=status,
+    )
+    db.close()
+
+    console.print(
+        Panel.fit(
+            f"[bold green]Content registered![/bold green]\n\n"
+            f"  ID:        [cyan]{entry['id']}[/cyan]\n"
+            f"  Title:     {entry['title'] or '[dim](untitled)[/dim]'}\n"
+            f"  Source:    {entry['source_path']}\n"
+            f"  Type:      {entry['content_type']}\n"
+            f"  Project:   {project or '[dim](none)[/dim]'}\n"
+            f"  Platform:  {platform or '[dim](none)[/dim]'}\n"
+            f"  Direction: {direction or '[dim](none)[/dim]'}\n"
+            f"  Status:    {entry['status']}",
+            title="📄 fgeo content",
+            border_style="green",
+        )
+    )
+
+
+@content_app.command("list")
+def list_content(
+    project: str = typer.Option("", "--project", "-P", help="Filter by project"),
+    platform: str = typer.Option("", "--platform", help="Filter by platform (requires --project)"),
+    status: str = typer.Option("", "--status", "-s", help="Filter by status: planned, draft, review, published"),
+    direction: str = typer.Option("", "--direction", "-d", help="Filter by direction"),
+    no_plan: bool = typer.Option(False, "--no-plan", help="Show only content not assigned to any plan"),
+) -> None:
+    """List content assets."""
+    db = get_db()
+    entries = db.list_contents(
+        project_name=project,
+        platform_name=platform,
+        status=status,
+        direction=direction,
+        no_plan=no_plan,
+    )
+    db.close()
+
+    if not entries:
+        console.print("[yellow]No content found matching filters.[/yellow]")
+        console.print("  Run: [cyan]fgeo content register <file>[/cyan]")
+        return
+
+    table = Table(title=f"📚 Content ({len(entries)} items)")
+    table.add_column("ID", style="cyan", no_wrap=True)
+    table.add_column("Title", style="bold")
+    table.add_column("Type", style="magenta")
+    table.add_column("Project", style="blue")
+    table.add_column("Platform", style="green")
+    table.add_column("Direction")
+    table.add_column("Status", style="yellow")
+    table.add_column("Created", style="dim")
+
+    for e in entries:
+        table.add_row(
+            e["id"],
+            (e["title"][:30] + "...") if len(e["title"] or "") > 30 else (e["title"] or ""),
+            e["content_type"],
+            e.get("project_name") or "-",
+            e.get("platform_name") or "-",
+            e["direction"] or "-",
+            e["status"],
+            e["created_at"][:10],
+        )
+
+    console.print(table)
+
+
+@content_app.command("show")
+def show(
+    content_id: str = typer.Argument(help="Content ID"),
+) -> None:
+    """Show content details."""
+    db = get_db()
+    entry = db.get_content(content_id)
+    db.close()
+
+    if not entry:
+        console.print(f"[red]Content not found: {content_id}[/red]")
+        raise typer.Exit(1)
+
+    source_exists = Path(entry["source_path"]).exists() if entry["source_path"] else False
+
+    console.print(
+        Panel.fit(
+            f"  ID:          [cyan]{entry['id']}[/cyan]\n"
+            f"  Title:       [bold]{entry['title'] or '(untitled)'}[/bold]\n"
+            f"  Description: {entry['description'] or '(none)'}\n"
+            f"  Source:      {entry['source_path'] or '(none)'} {'✓' if source_exists else '✗'}\n"
+            f"  Type:        {entry['content_type']}\n"
+            f"  Direction:   {entry['direction'] or '(none)'}\n"
+            f"  Tags:        {entry['tags'] or '(none)'}\n"
+            f"  Status:      {entry['status']}\n"
+            f"  URL:         {entry['published_url'] or '(none)'}\n"
+            f"  Published:   {entry['published_at'] or '-'}\n"
+            f"  Created:     {entry['created_at']}\n"
+            f"  Updated:     {entry['updated_at']}",
+            title="📄 Content Detail",
+            border_style="blue",
+        )
+    )
+
+
+@content_app.command("set")
+def set_field(
+    content_id: str = typer.Argument(help="Content ID"),
+    field: str = typer.Argument(help="Field to update: title, description, direction, tags, status, published_url, etc."),
+    value: str = typer.Argument(help="New value"),
+) -> None:
+    """Update a content field."""
+    db = get_db()
+    result = db.update_content(content_id, field, value)
+    db.close()
+
+    if not result:
+        console.print(f"[red]Failed to update. Check content ID and field name ({field}).[/red]")
+        raise typer.Exit(1)
+
+    console.print(f"[green]✓[/green] Content {content_id}: {field} → {value}")
+
+
+@content_app.command("assign-plan")
+def assign_plan(
+    project: str = typer.Argument(help="Project name"),
+    plan: str = typer.Argument(help="Plan name"),
+    content_id: str = typer.Option("", "--id", "-i", help="Assign a single content by ID (ignores --platform and --status)."),
+    platform: list[str] = typer.Option([], "--platform", "-p", help="Filter by platform name (repeatable). Omit to target all platforms."),
+    status: str = typer.Option("", "--status", "-s", help="Filter by content status (draft, published, planned, …). Omit to target all."),
+) -> None:
+    """Batch-assign a plan to all matching content in a project.
+
+    To assign a single content item, use --id:
+      fgeo content assign-plan myproj gtm-v1 --id cont-abc123
+
+    Examples:
+      fgeo content assign-plan myproj gtm-v1
+      fgeo content assign-plan myproj gtm-v1 --platform devto --platform medium
+      fgeo content assign-plan myproj gtm-v1 --platform twitter --status published
+    """
+    db = get_db()
+    try:
+        if content_id:
+            entry = db.get_content(content_id)
+            if not entry:
+                console.print(f"[red]Content not found: {content_id}[/red]")
+                raise typer.Exit(1)
+            plan_obj = db.get_plan(project, plan)
+            if not plan_obj:
+                console.print(f"[red]Plan not found: {plan} in project {project}[/red]")
+                raise typer.Exit(1)
+            db.update_content(content_id, "plan_id", plan_obj["id"])
+            console.print(f"[green]✓[/green] Assigned plan [bold]{plan}[/bold] to content {content_id}")
+            return
+        count = db.assign_plan_to_contents(
+            project_name=project,
+            plan_name=plan,
+            platform_names=list(platform) or None,
+            status=status,
+        )
+    except ValueError as exc:
+        console.print(f"[red]{exc}[/red]")
+        raise typer.Exit(1)
+    finally:
+        db.close()
+
+    filters: list[str] = []
+    if platform:
+        filters.append(f"platform: {', '.join(platform)}")
+    if status:
+        filters.append(f"status: {status}")
+    filter_str = f"  [dim]({', '.join(filters)})[/dim]" if filters else ""
+    console.print(f"[green]✓[/green] Assigned plan [bold]{plan}[/bold] to {count} content(s).{filter_str}")
+
+
+@content_app.command("remove")
+def remove(
+    content_id: str = typer.Argument(help="Content ID to remove"),
+    force: bool = typer.Option(False, "--force", "-f", help="Skip confirmation"),
+) -> None:
+    """Remove a content entry from the registry."""
+    db = get_db()
+    entry = db.get_content(content_id)
+
+    if not entry:
+        console.print(f"[red]Content not found: {content_id}[/red]")
+        db.close()
+        raise typer.Exit(1)
+
+    if not force:
+        console.print(f"  Removing: [bold]{entry['title'] or content_id}[/bold]")
+        if not typer.confirm("Are you sure?", default=False):
+            db.close()
+            raise typer.Abort()
+
+    db.remove_content(content_id)
+    db.close()
+    console.print(f"[green]✓[/green] Removed content: {content_id}")