opencontext-cli 0.2.1b0__tar.gz → 0.3.0__tar.gz

{opencontext_cli-0.2.1b0 → opencontext_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencontext-cli
-Version: 0.2.1b0
+Version: 0.3.0
 Summary: CLI adapter for OpenContext Runtime
 Author: OpenContext Runtime maintainers
 License-Expression: MIT

opencontext_cli-0.3.0/opencontext_cli/__main__.py

@@ -0,0 +1,5 @@
+"""CLI entry point for `python -m opencontext_cli`."""
+
+from opencontext_cli.main import main
+
+main()

{opencontext_cli-0.2.1b0 → opencontext_cli-0.3.0}/opencontext_cli/commands/ci_check_cmd.py

@@ -3,17 +3,64 @@
 from __future__ import annotations
 
 import json
+from pathlib import Path
 from typing import Any
 
 from opencontext_core.dx.console_styles import console
 from opencontext_core.quality.ci_checks import CheckRunner
 
+CONTEXTBENCH_WORKFLOW = """\
+# OpenContext ContextBench CI
+# Auto-generated by `opencontext ci-check init`
+name: OpenContext ContextBench
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  contextbench:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install OpenContext
+        run: pip install opencontext-cli
+      - name: Initialize checks
+        run: opencontext ci-check init
+      - name: Run ContextBench checks
+        run: opencontext ci-check run --json > contextbench-report.json
+      - name: Upload report
+        uses: actions/upload-artifact@v4
+        with:
+          name: contextbench-report
+          path: contextbench-report.json
+      - name: Fail on errors
+        run: |
+          python3 -c "
+          import json
+          with open('contextbench-report.json') as f:
+              report = json.load(f)
+          summary = report.get('summary', {})
+          if summary.get('failed', 0) > 0:
+              print('❌ ContextBench checks failed')
+              exit(1)
+          print('✅ All ContextBench checks passed')
+          "
+"""
+
 
 def add_ci_check_parser(subparsers: Any) -> None:
     """Add ci-check command parsers."""
     check_parser = subparsers.add_parser("ci-check", help="CI check management.")
     check_sub = check_parser.add_subparsers(dest="ci_check_command", required=True)
-    check_sub.add_parser("init", help="Initialize checks directory.")
+    check_init = check_sub.add_parser(
+        "init", help="Initialize checks directory and ContextBench workflow."
+    )
+    check_init.add_argument(
+        "--no-workflow", action="store_true", help="Skip GitHub Actions workflow generation."
+    )
     check_sub.add_parser("list", help="List discovered checks.")
     check_run = check_sub.add_parser("run", help="Run all checks.")
     check_run.add_argument("--file", help="Run on specific file only.")
@@ -21,6 +68,10 @@ def add_ci_check_parser(subparsers: Any) -> None:
     check_create = check_sub.add_parser("create", help="Create a new check template.")
     check_create.add_argument("name", help="Check name.")
     check_create.add_argument("--description", default="", help="Check description.")
+    check_gh = check_sub.add_parser(
+        "github-actions", help="Generate ContextBench GitHub Actions workflow."
+    )
+    check_gh.add_argument("--force", action="store_true", help="Overwrite existing workflow file.")
 
 
 def handle_ci_check(args: Any) -> None:
@@ -35,6 +86,18 @@ def handle_ci_check(args: Any) -> None:
     if command == "init":
         path = runner.init_checks_directory()
         console.success(f"Initialized checks directory: {path}")
+        skip_workflow = getattr(args, "no_workflow", False)
+        if not skip_workflow:
+            workflow_path = _generate_contextbench_workflow()
+            console.success(f"Generated ContextBench workflow: {workflow_path}")
+    elif command == "github-actions":
+        force = getattr(args, "force", False)
+        workflow_path = Path(".github/workflows/opencontext-contextbench.yml")
+        if workflow_path.exists() and not force:
+            console.warning(f"Workflow already exists: {workflow_path}. Use --force to overwrite.")
+            return
+        _write_contextbench_workflow(workflow_path)
+        console.success(f"Generated ContextBench workflow: {workflow_path}")
     elif command == "list":
         checks = runner.discover_checks()
         if json_output:
@@ -113,3 +176,16 @@ def _display_check_report(report: dict[str, Any]) -> None:
                 console.print(f"    [dim]File: {r['file']}:{r.get('line', 'N/A')}[/]")
             if r.get("suggestion"):
                 console.print(f"    [dim]Suggestion: {r['suggestion']}[/]")
+
+
+def _generate_contextbench_workflow() -> Path:
+    """Generate the ContextBench GitHub Actions workflow as part of init."""
+    workflow_path = Path(".github/workflows/opencontext-contextbench.yml")
+    _write_contextbench_workflow(workflow_path)
+    return workflow_path
+
+
+def _write_contextbench_workflow(workflow_path: Path) -> None:
+    """Write the ContextBench workflow file."""
+    workflow_path.parent.mkdir(parents=True, exist_ok=True)
+    workflow_path.write_text(CONTEXTBENCH_WORKFLOW)

{opencontext_cli-0.2.1b0 → opencontext_cli-0.3.0}/opencontext_cli/commands/config_cmd.py

@@ -79,7 +79,13 @@ def handle_config(args: Any) -> None:
     command = args.config_command
 
     if command == "wizard":
-        run_wizard(non_interactive=getattr(args, "non_interactive", False))
+        use_tui = not getattr(args, "non_interactive", False)
+        if use_tui:
+            from opencontext_core.wizard import run_wizard_menu
+
+            run_wizard_menu()
+        else:
+            run_wizard(non_interactive=True)
     elif command == "show":
         show_config()
     elif command == "reset":
@@ -100,56 +106,131 @@ def handle_config(args: Any) -> None:
         _config_cleanup(args.keep_days)
 
 
+# ── Dot-notation config paths ──────────────────────────────────────────────
+
+# Schema of configurable paths: "path" -> (type, description)
+CONFIG_PATHS: dict[str, tuple[type, str]] = {
+    # Flat keys
+    "security_mode": (str, "Security mode: private_project, enterprise, or air-gapped"),
+    "default_token_budget": (int, "Default token budget per operation"),
+    "max_input_tokens": (int, "Maximum input tokens"),
+    "reserve_output_tokens": (int, "Reserved output tokens"),
+    "check_updates": (bool, "Check for updates automatically"),
+    "auto_optimize": (bool, "Auto-optimize token budgets based on usage"),
+    "first_run": (bool, "Whether this is the first run"),
+    "default_provider": (str, "Default LLM provider"),
+    "default_model": (str, "Default LLM model"),
+    # Nested: features.*
+    "features.knowledge_graph": (bool, "Knowledge Graph (code indexing & search)"),
+    "features.call_graph": (bool, "Call Graph (function call analysis)"),
+    "features.learning_system": (bool, "Learning System (auto-optimize)"),
+    "features.governance": (bool, "Governance (audit trails & policies)"),
+    "features.mcp_server": (bool, "MCP Server (agent integration)"),
+    "features.git_integration": (bool, "Git Integration"),
+    "features.embeddings": (bool, "Embeddings (semantic search)"),
+    "features.semantic_search": (bool, "Semantic Search"),
+    # Nested: sdd.*
+    "sdd.tdd_mode": (str, "TDD mode: ask, strict, or off"),
+    "sdd.sdd_model_profile": (str, "SDD model profile: default, cheap, hybrid, premium"),
+    "sdd.orchestrator_profile": (
+        str,
+        "Orchestrator profile: solo-compact, multi-phase, subagent-native",
+    ),
+    # Nested: agents.*
+    "agents.default_client": (str, "Default agent client"),
+    "agents.active_clients": (list, "Active agent clients (comma-separated)"),
+}
+
+
+def _resolve_config_path(prefs: Any, dotted: str) -> tuple[Any, str] | None:
+    """Resolve a dotted path to (parent_object, attr_name) or None if invalid.
+
+    Example: "features.knowledge_graph" -> (prefs.features, "knowledge_graph")
+    """
+    parts = dotted.split(".")
+    obj = prefs
+    for _i, part in enumerate(parts[:-1]):
+        if hasattr(obj, part):
+            obj = getattr(obj, part)
+        else:
+            return None
+    return (obj, parts[-1])
+
+
+def _get_all_config_paths() -> list[str]:
+    """Return all available config paths sorted."""
+    return sorted(CONFIG_PATHS.keys())
+
+
+def _coerce_value(value: str, target_type: type) -> object:
+    """Coerce a string value to the target type."""
+    if target_type is bool:
+        return value.lower() in ("true", "1", "yes", "on")
+    elif target_type is int:
+        return int(value)
+    elif target_type is list:
+        import json
+
+        try:
+            parsed = json.loads(value)
+            if isinstance(parsed, list):
+                return parsed
+        except (json.JSONDecodeError, TypeError):
+            pass
+        # Fallback: comma-separated
+        return [item.strip() for item in value.split(",") if item.strip()]
+    else:
+        return value
+
+
 def _config_set(key: str, value: str) -> None:
-    """Set a config value by key."""
+    """Set a config value using dot notation."""
 
     store = UserConfigStore()
     prefs = store.load()
 
-    # Simple key-value mapping
-    key_map: dict[str, tuple[str, type]] = {
-        "security_mode": ("security_mode", str),
-        "token_budget": ("default_token_budget", int),
-        "max_input_tokens": ("max_input_tokens", int),
-        "check_updates": ("check_updates", bool),
-        "auto_optimize": ("learning_auto_optimize", bool),
-    }
-
-    if key in key_map:
-        attr_name, attr_type = key_map[key]
-        if attr_type is bool:
-            parsed = value.lower() in ("true", "1", "yes", "on")
-        elif attr_type is int:
-            parsed = int(value)
-        else:
-            parsed = value
-        setattr(prefs, attr_name, parsed)
-        store.save(prefs)
-        print(f"Set {key} = {parsed}")
+    if key in CONFIG_PATHS:
+        _target_type, _description = CONFIG_PATHS[key]
+        resolved = _resolve_config_path(prefs, key)
+        if resolved is None:
+            print(f"Error: Cannot resolve path '{key}'")
+            return
+        parent, attr = resolved
+        try:
+            parsed = _coerce_value(value, _target_type)
+            setattr(parent, attr, parsed)
+            store.save(prefs)
+            print(f"Set {key} = {parsed}")
+        except (ValueError, TypeError) as exc:
+            print(f"Error: Cannot set '{key}' to '{value}': {exc}")
+            print(f"Expected type: {_target_type.__name__}")
     else:
         print(f"Unknown key: {key}")
-        print(f"Available: {', '.join(key_map.keys())}")
+        print(f"Available paths ({len(CONFIG_PATHS)}):")
+        for path, (typ, desc) in sorted(CONFIG_PATHS.items()):
+            print(f"  {path}  ({typ.__name__})  {desc}")
 
 
 def _config_get(key: str) -> None:
-    """Get a config value by key."""
+    """Get a config value by dot-notation key."""
 
     store = UserConfigStore()
     prefs = store.load()
 
-    key_map = {
-        "security_mode": prefs.security_mode,
-        "token_budget": prefs.default_token_budget,
-        "max_input_tokens": prefs.max_input_tokens,
-        "check_updates": prefs.check_updates,
-        "auto_optimize": prefs.learning_auto_optimize,
-        "first_run": prefs.first_run,
-    }
-
-    if key in key_map:
-        print(f"{key} = {key_map[key]}")
+    if key in CONFIG_PATHS:
+        _target_type, _description = CONFIG_PATHS[key]
+        resolved = _resolve_config_path(prefs, key)
+        if resolved is None:
+            print(f"Error: Cannot resolve path '{key}'")
+            return
+        parent, attr = resolved
+        value = getattr(parent, attr, "<not set>")
+        print(f"{key} = {value}")
     else:
         print(f"Unknown key: {key}")
+        print(f"Available paths ({len(CONFIG_PATHS)}):")
+        for path, (typ, desc) in sorted(CONFIG_PATHS.items()):
+            print(f"  {path}  ({typ.__name__})  {desc}")
 
 
 def _config_backup() -> None:

{opencontext_cli-0.2.1b0 → opencontext_cli-0.3.0}/opencontext_cli/commands/plugin_cmd.py

@@ -3,6 +3,7 @@
 Usage:
   opencontext plugin list              List installed plugins
   opencontext plugin search [query]    Search remote registry
+  opencontext plugin init <name>       Scaffold a new plugin
   opencontext plugin install <name>    Install from registry
   opencontext plugin install <name> --github owner/repo
   opencontext plugin install <name> --url <url>
@@ -16,6 +17,7 @@ Usage:
 from __future__ import annotations
 
 import json
+from pathlib import Path
 from typing import Any
 
 from opencontext_core.plugin_system import (
@@ -44,6 +46,18 @@ def add_plugin_parser(subparsers: Any) -> None:
         "--refresh", action="store_true", help="Force refresh registry cache."
     )
 
+    # Init
+    init_parser = plugin_sub.add_parser("init", help="Scaffold a new plugin.")
+    init_parser.add_argument("name", help="Plugin name (alphanumeric + hyphens).")
+    init_parser.add_argument("--description", default="", help="Short plugin description.")
+    init_parser.add_argument("--author", default="", help="Plugin author name.")
+    init_parser.add_argument(
+        "--template",
+        choices=["basic", "advanced"],
+        default="basic",
+        help="Scaffold template to use (default: basic).",
+    )
+
     # Install
     install_parser = plugin_sub.add_parser("install", help="Install a plugin.")
     install_parser.add_argument("name", help="Plugin name.")
@@ -65,6 +79,7 @@ def add_plugin_parser(subparsers: Any) -> None:
     # Info
     info_parser = plugin_sub.add_parser("info", help="Show plugin details.")
     info_parser.add_argument("name", help="Plugin name.")
+    info_parser.add_argument("--json", action="store_true", help="Output as JSON.")
 
     # Enable/Disable
     enable_parser = plugin_sub.add_parser("enable", help="Enable a plugin.")
@@ -83,6 +98,8 @@ def handle_plugin(args: Any) -> None:
         _plugin_list(args)
     elif command == "search":
         _plugin_search(args)
+    elif command == "init":
+        _plugin_init(args)
     elif command == "install":
         _plugin_install(args)
     elif command == "remove":
@@ -180,6 +197,107 @@ def _plugin_search(args: Any) -> None:
     print("  Details:  opencontext plugin info <name>")
 
 
+def _plugin_init(args: Any) -> None:
+    """Scaffold a new plugin directory."""
+
+    name = args.name.strip()
+    if not name.replace("-", "").replace("_", "").isalnum():
+        print(f"\n  ✗ Invalid plugin name: '{name}'. Use alphanumeric, hyphens, or underscores.\n")
+        return
+
+    plugin_dir = Path.cwd() / name
+    if plugin_dir.exists():
+        print(f"\n  ✗ Directory '{name}' already exists.\n")
+        return
+
+    description = args.description or f"Plugin '{name}'"
+    author = args.author or ""
+    class_name = "".join(part.capitalize() for part in name.replace("-", "_").split("_"))
+    if class_name.endswith("Plugin"):
+        base_name = class_name
+    else:
+        base_name = f"{class_name}Plugin"
+
+    plugin_dir.mkdir(parents=True, exist_ok=True)
+
+    # --- plugin.yaml ---
+    yaml_content = (
+        f"name: {name}\n"
+        f"version: 0.1.0\n"
+        f"description: {description}\n"
+        f"author: {author}\n"
+        f"entry_point: plugin.py\n"
+        f"hooks: []\n"
+    )
+    (plugin_dir / "plugin.yaml").write_text(yaml_content, encoding="utf-8")
+    print(f"  ✓ Created {name}/plugin.yaml")
+
+    # --- plugin.py ---
+    if args.template == "advanced":
+        plugin_py = (
+            f'"""Advanced {name} plugin."""\n\n'
+            f"from __future__ import annotations\n\n"
+            f"from typing import Any\n\n\n"
+            f"class {base_name}:\n"
+            f'    """{name} plugin."""\n\n'
+            f"    @property\n"
+            f"    def name(self) -> str:\n"
+            f'        return "{name}"\n\n'
+            f"    @property\n"
+            f"    def version(self) -> str:\n"
+            f'        return "0.1.0"\n\n'
+            f"    @property\n"
+            f"    def description(self) -> str:\n"
+            f'        return "{description}"\n\n'
+            f"    def initialize(self, context: dict[str, Any]) -> None:\n"
+            f'        """Called when plugin is loaded."""\n'
+            f"        pass\n\n"
+            f"    def shutdown(self) -> None:\n"
+            f'        """Called when plugin is unloaded."""\n'
+            f"        pass\n\n"
+            f"    def register_commands(self, registry: Any) -> None:\n"
+            f'        """Register CLI commands."""\n'
+            f"        pass\n\n"
+            f"    def register_hooks(self, registry: Any) -> None:\n"
+            f'        """Register hooks."""\n'
+            f'        registry.register_hook("post_execute", self.on_post_execute)\n\n'
+            f"    def on_post_execute(self, result: Any) -> None:\n"
+            f"        pass\n"
+        )
+    else:
+        plugin_py = (
+            f'"""{name} plugin."""\n\n\n'
+            f"class {base_name}:\n"
+            f"    @property\n"
+            f"    def name(self):\n"
+            f'        return "{name}"\n'
+            f"\n"
+            f"    @property\n"
+            f"    def version(self):\n"
+            f'        return "0.1.0"\n'
+            f"\n"
+            f"    @property\n"
+            f"    def description(self):\n"
+            f'        return "{description}"\n'
+        )
+    (plugin_dir / "plugin.py").write_text(plugin_py, encoding="utf-8")
+    print(f"  ✓ Created {name}/plugin.py")
+
+    # --- README.md ---
+    readme = (
+        f"# {name}\n\n"
+        f"{description}\n\n"
+        f"## Installation\n\n"
+        f"```bash\nopencontext plugin install {name}\n```\n\n"
+        f"## Usage\n\n"
+        f"Describe how to use this plugin.\n"
+    )
+    (plugin_dir / "README.md").write_text(readme, encoding="utf-8")
+    print(f"  ✓ Created {name}/README.md")
+
+    print(f"\n  Plugin '{name}' scaffolded. Edit plugin.py to add your logic.\n")
+
+
 def _plugin_install(args: Any) -> None:
     """Install a plugin."""
 
@@ -289,6 +407,46 @@ def _plugin_info(args: Any) -> None:
     registry = PluginRegistry()
     info = registry.get_info(args.name)
 
+    # Check registry for latest version
+    latest_version = "unknown"
+    try:
+        fetcher = RegistryFetcher()
+        entry = fetcher.get(args.name)
+        if entry and entry.versions:
+            latest_version = entry.versions[0].version
+    except Exception:
+        pass
+
+    if args.json:
+        if info is None:
+            data = {
+                "name": args.name,
+                "installed": False,
+                "latest": latest_version,
+            }
+        else:
+            data = {
+                "name": info.name,
+                "installed": True,
+                "version": info.version,
+                "latest": latest_version,
+                "description": info.description,
+                "author": info.author,
+                "homepage": info.homepage,
+                "repository": info.repository,
+                "enabled": info.enabled,
+                "install_source": info.install_source,
+                "source_url": info.source_url,
+                "entry_point": info.entry_point,
+                "installed_at": info.installed_at,
+                "updated_at": info.updated_at,
+                "hooks": info.hooks,
+            }
+            if latest_version != "unknown" and latest_version != info.version:
+                data["update_available"] = True
+        print(json.dumps(data, indent=2))
+        return
+
     if info is None:
         # Check registry
         fetcher = RegistryFetcher()
@@ -311,11 +469,15 @@ def _plugin_info(args: Any) -> None:
     print(f"\n  {info.name}")
     print(f"  {'─' * len(info.name)}")
     print(f"  Version:      {info.version}")
+    if latest_version != "unknown" and latest_version != info.version:
+        print(f"  Latest:       {latest_version}  (update available)")
+    else:
+        print(f"  Latest:       {latest_version}")
     print(f"  Description:  {info.description}")
     print(f"  Author:       {info.author or '—'}")
     print(f"  Homepage:     {info.homepage or '—'}")
     print(f"  Repository:   {info.repository or '—'}")
-    print(f"  Status:       {'✓ enabled' if info.enabled else '○ disabled'}")
+    print(f"  Status:       {'enabled' if info.enabled else 'disabled'}")
     print(f"  Source:       {info.install_source}")
     print(f"  Source URL:   {info.source_url or '—'}")
     print(f"  Entry point:  {info.entry_point}")