code-agnostic 0.3.12__tar.gz → 0.3.13__tar.gz

{code_agnostic-0.3.12 → code_agnostic-0.3.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-agnostic
-Version: 0.3.12
+Version: 0.3.13
 Summary: Centralized hub for LLM coding config: MCP, skills, rules, and agents.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -66,19 +66,19 @@ Today the implementation is still mixed: some assets are compiled and some are s
 
 ## Scope model
 
-`code-agnostic` has two managed source scopes today:
+`code-agnostic` has three managed source scopes:
 
 - global source config under `~/.config/code-agnostic/`, synced to enabled
   user-level app config;
 - workspace source config under `~/.config/code-agnostic/workspaces/<name>/`,
-  propagated into repos inside a registered workspace.
+  propagated into repos inside a registered workspace;
+- project source config under `~/.config/code-agnostic/projects/<name>/`,
+  synced to exactly one registered project directory.
 
 Workspace sync may generate repo-local outputs, but those outputs are not
-source. Project-local skill folders that users create directly inside a repo,
-such as `.agents/skills` or `.opencode/skills`, are app-native inputs but are
-not managed as source by `code-agnostic` yet. First-class project-scoped
-installs are planned so a single registered project can have managed local
-source config without bypassing the hub.
+source. Project-local skill folders generated inside a repo, such as
+`.agents/skills` or `.opencode/skills`, are also generated outputs; install
+skills into managed project source first, then run `plan` / `apply`.
 
 ## Install
 
@@ -230,19 +230,27 @@ code-agnostic skills list
 code-agnostic agents list
 ```
 
-Manual skill install today:
+Install a local skill directory into managed source:
 
 ```bash
-mkdir -p ~/.config/code-agnostic/skills
-cp -R ./my-skill ~/.config/code-agnostic/skills/my-skill
+code-agnostic skills install ./my-skill --global
+code-agnostic skills install ./my-skill --workspace myworkspace
+code-agnostic projects add --name myproject --path .
+code-agnostic skills install ./my-skill --project myproject
 code-agnostic plan
 code-agnostic apply
 ```
 
-There is no `skills install` command yet; copy skills into managed source first,
-then use the normal `plan` / `apply` workflow.
-
-Global skills live under `~/.config/code-agnostic/skills`. Workspace-local skills live under `~/.config/code-agnostic/workspaces/<name>/skills` and can be inspected with `code-agnostic skills list -w <name>`. Codex generated skill outputs are written to `~/.agents/skills`, while Codex agents and config remain under `CODEX_HOME` when set, defaulting to `~/.codex`. Claude Code generated skills and agents are written under `~/.claude/skills` and `~/.claude/agents`, with workspace copies under repo-local `.claude/skills` and `.claude/agents`.
+Global skills live under `~/.config/code-agnostic/skills`. Workspace-local
+skills live under `~/.config/code-agnostic/workspaces/<name>/skills` and can be
+inspected with `code-agnostic skills list -w <name>`. Project-local skills live
+under `~/.config/code-agnostic/projects/<name>/skills` and are generated into
+the registered project directory by `plan` / `apply`. Codex generated skill
+outputs are written to `~/.agents/skills`, while Codex agents and config remain
+under `CODEX_HOME` when set, defaulting to `~/.codex`. Claude Code generated
+skills and agents are written under `~/.claude/skills` and `~/.claude/agents`,
+with workspace/project copies under repo-local `.claude/skills` and
+`.claude/agents`.
 
 Project-local skills are not first-class source inputs in `code-agnostic` yet. If a target app discovers repo-local skill folders such as `.agents/skills`, `.opencode/skills`, or user-created `.claude/skills`, treat those as unmanaged app inputs. Workspace sync writes only the exact generated paths recorded in `.sync-state.json`.
 

{code_agnostic-0.3.12 → code_agnostic-0.3.13}/README.md

@@ -41,19 +41,19 @@ Today the implementation is still mixed: some assets are compiled and some are s
 
 ## Scope model
 
-`code-agnostic` has two managed source scopes today:
+`code-agnostic` has three managed source scopes:
 
 - global source config under `~/.config/code-agnostic/`, synced to enabled
   user-level app config;
 - workspace source config under `~/.config/code-agnostic/workspaces/<name>/`,
-  propagated into repos inside a registered workspace.
+  propagated into repos inside a registered workspace;
+- project source config under `~/.config/code-agnostic/projects/<name>/`,
+  synced to exactly one registered project directory.
 
 Workspace sync may generate repo-local outputs, but those outputs are not
-source. Project-local skill folders that users create directly inside a repo,
-such as `.agents/skills` or `.opencode/skills`, are app-native inputs but are
-not managed as source by `code-agnostic` yet. First-class project-scoped
-installs are planned so a single registered project can have managed local
-source config without bypassing the hub.
+source. Project-local skill folders generated inside a repo, such as
+`.agents/skills` or `.opencode/skills`, are also generated outputs; install
+skills into managed project source first, then run `plan` / `apply`.
 
 ## Install
 
@@ -205,19 +205,27 @@ code-agnostic skills list
 code-agnostic agents list
 ```
 
-Manual skill install today:
+Install a local skill directory into managed source:
 
 ```bash
-mkdir -p ~/.config/code-agnostic/skills
-cp -R ./my-skill ~/.config/code-agnostic/skills/my-skill
+code-agnostic skills install ./my-skill --global
+code-agnostic skills install ./my-skill --workspace myworkspace
+code-agnostic projects add --name myproject --path .
+code-agnostic skills install ./my-skill --project myproject
 code-agnostic plan
 code-agnostic apply
 ```
 
-There is no `skills install` command yet; copy skills into managed source first,
-then use the normal `plan` / `apply` workflow.
-
-Global skills live under `~/.config/code-agnostic/skills`. Workspace-local skills live under `~/.config/code-agnostic/workspaces/<name>/skills` and can be inspected with `code-agnostic skills list -w <name>`. Codex generated skill outputs are written to `~/.agents/skills`, while Codex agents and config remain under `CODEX_HOME` when set, defaulting to `~/.codex`. Claude Code generated skills and agents are written under `~/.claude/skills` and `~/.claude/agents`, with workspace copies under repo-local `.claude/skills` and `.claude/agents`.
+Global skills live under `~/.config/code-agnostic/skills`. Workspace-local
+skills live under `~/.config/code-agnostic/workspaces/<name>/skills` and can be
+inspected with `code-agnostic skills list -w <name>`. Project-local skills live
+under `~/.config/code-agnostic/projects/<name>/skills` and are generated into
+the registered project directory by `plan` / `apply`. Codex generated skill
+outputs are written to `~/.agents/skills`, while Codex agents and config remain
+under `CODEX_HOME` when set, defaulting to `~/.codex`. Claude Code generated
+skills and agents are written under `~/.claude/skills` and `~/.claude/agents`,
+with workspace/project copies under repo-local `.claude/skills` and
+`.claude/agents`.
 
 Project-local skills are not first-class source inputs in `code-agnostic` yet. If a target app discovers repo-local skill folders such as `.agents/skills`, `.opencode/skills`, or user-created `.claude/skills`, treat those as unmanaged app inputs. Workspace sync writes only the exact generated paths recorded in `.sync-state.json`.
 

{code_agnostic-0.3.12 → code_agnostic-0.3.13}/code_agnostic/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "0.3.12"
+__version__ = "0.3.13"

{code_agnostic-0.3.12 → code_agnostic-0.3.13}/code_agnostic/__main__.py

@@ -10,6 +10,7 @@ from code_agnostic.cli.commands.explain_lossiness import explain_lossiness
 from code_agnostic.cli.commands.import_ import import_group
 from code_agnostic.cli.commands.mcp import mcp
 from code_agnostic.cli.commands.plan import plan
+from code_agnostic.cli.commands.projects import projects
 from code_agnostic.cli.commands.restore import restore
 from code_agnostic.cli.commands.rules import rules
 from code_agnostic.cli.commands.skills import skills
@@ -40,6 +41,7 @@ cli.add_command(explain_lossiness)
 # Register command groups
 cli.add_command(apps)
 cli.add_command(workspaces)
+cli.add_command(projects)
 cli.add_command(rules)
 cli.add_command(skills)
 cli.add_command(agents_group)

code_agnostic-0.3.13/code_agnostic/cli/commands/projects.py

@@ -0,0 +1,78 @@
+"""Projects group commands."""
+
+from pathlib import Path
+
+import click
+
+from code_agnostic.core.project_repository import ProjectConfigRepository
+from code_agnostic.core.repository import CoreRepository
+from code_agnostic.errors import SyncAppError
+
+
+@click.group(help="Manage project roots for project-local source config.")
+def projects() -> None:
+    pass
+
+
+@projects.command("add", help="Add a project by name and path.")
+@click.option("--name", required=True, help="Project name.")
+@click.option(
+    "--path",
+    required=True,
+    type=click.Path(path_type=Path),
+    help="Project root path.",
+)
+@click.pass_obj
+def projects_add(obj: dict[str, str], name: str, path: Path) -> None:
+    core = CoreRepository()
+    try:
+        core.add_project(name, path)
+    except (ValueError, SyncAppError) as exc:
+        raise click.ClickException(str(exc))
+    click.echo(f"Project added: {name.strip()}")
+    click.echo(str(path.expanduser().resolve()))
+
+
+@projects.command("remove", help="Unregister a project by name.")
+@click.option("--name", required=True, help="Project name to unregister.")
+@click.pass_obj
+def projects_remove(obj: dict[str, str], name: str) -> None:
+    core = CoreRepository()
+    try:
+        removed = core.remove_project(name)
+    except SyncAppError as exc:
+        raise click.ClickException(str(exc))
+    if not removed:
+        raise click.ClickException(f"Project not found: {name}")
+    click.echo(f"Project unregistered: {name}")
+
+
+@projects.command("list", help="List configured projects.")
+@click.pass_obj
+def projects_list(obj: dict[str, str]) -> None:
+    core = CoreRepository()
+    try:
+        items = core.load_projects()
+    except SyncAppError as exc:
+        raise click.ClickException(str(exc))
+
+    if not items:
+        click.echo("No projects configured.")
+        click.echo("code-agnostic projects add --name <name> --path <path>")
+        return
+
+    for item in items:
+        project_source = ProjectConfigRepository(
+            root=core.project_config_dir(item["name"])
+        )
+        markers = []
+        if project_source.has_mcp():
+            markers.append("mcp")
+        if project_source.has_rules():
+            markers.append("rules")
+        if project_source.has_skills():
+            markers.append("skills")
+        if project_source.has_agents():
+            markers.append("agents")
+        suffix = f" [{', '.join(markers)}]" if markers else ""
+        click.echo(f"{item['name']}: {item['path']}{suffix}")

code_agnostic-0.3.13/code_agnostic/cli/commands/skills.py

@@ -0,0 +1,192 @@
+"""Skills group commands."""
+
+from pathlib import Path
+import shutil
+
+import click
+from rich.console import Console
+
+from code_agnostic.cli.helpers import validate_resource_name, workspace_config_root
+from code_agnostic.cli.options import workspace_option
+from code_agnostic.core.repository import CoreRepository
+from code_agnostic.errors import SyncAppError
+from code_agnostic.tui import SyncConsoleUI
+from code_agnostic.utils import compact_home_path
+
+
+def _is_skill_source(path: Path) -> bool:
+    return path.is_dir() and (
+        (path / "SKILL.md").exists()
+        or ((path / "meta.yaml").exists() and (path / "prompt.md").exists())
+    )
+
+
+def _entries_containing_cwd(
+    entries: list[dict[str, str]], cwd: Path
+) -> list[dict[str, str]]:
+    matches = []
+    for entry in entries:
+        root = Path(entry["path"]).expanduser().resolve()
+        if cwd == root or cwd.is_relative_to(root):
+            matches.append(entry)
+    return matches
+
+
+def _project_entries_by_name(core: CoreRepository) -> dict[str, dict[str, str]]:
+    return {item["name"]: item for item in core.load_projects()}
+
+
+def _install_root(
+    core: CoreRepository,
+    *,
+    global_scope: bool,
+    workspace: str | None,
+    project: str | None,
+) -> tuple[Path, str, str | None]:
+    explicit_count = sum(
+        [global_scope, workspace is not None, project is not None],
+    )
+    if explicit_count > 1:
+        raise click.ClickException(
+            "Choose only one scope: --global, --workspace, or --project."
+        )
+
+    try:
+        if global_scope:
+            return core.root, "global", None
+        if workspace is not None:
+            return (
+                workspace_config_root(core, workspace),
+                f"workspace:{workspace}",
+                None,
+            )
+        if project is not None:
+            projects = _project_entries_by_name(core)
+            if project not in projects:
+                raise click.ClickException(f"Project not found: {project}")
+            return core.project_config_dir(project), f"project:{project}", None
+
+        cwd = Path.cwd().resolve()
+        project_matches = _entries_containing_cwd(core.load_projects(), cwd)
+        if len(project_matches) == 1:
+            name = project_matches[0]["name"]
+            return core.project_config_dir(name), f"project:{name}", None
+
+        workspace_matches = _entries_containing_cwd(core.load_workspaces(), cwd)
+        if len(project_matches) == 0 and len(workspace_matches) == 1:
+            name = workspace_matches[0]["name"]
+            return core.workspace_config_dir(name), f"workspace:{name}", None
+    except SyncAppError as exc:
+        raise click.ClickException(str(exc)) from exc
+
+    raise click.ClickException(
+        "No unique project/workspace scope detected. Use --global, --project, "
+        "or --workspace."
+    )
+
+
+@click.group(
+    help=(
+        "Manage source skill definitions. Commands use global source by default; "
+        "pass -w/--workspace for workspace source."
+    )
+)
+def skills() -> None:
+    pass
+
+
+@skills.command("install", help="Install a local skill directory into source config.")
+@click.argument("source", type=click.Path(path_type=Path))
+@click.option("--global", "global_scope", is_flag=True, help="Install globally.")
+@workspace_option()
+@click.option("--project", help="Install into a registered project source.")
+@click.pass_obj
+def skills_install(
+    obj: dict[str, str],
+    source: Path,
+    global_scope: bool,
+    workspace: str | None,
+    project: str | None,
+) -> None:
+    source = source.expanduser().resolve()
+    if not _is_skill_source(source):
+        raise click.ClickException(
+            "Invalid skill source: expected a directory containing SKILL.md "
+            "or meta.yaml and prompt.md."
+        )
+
+    name = source.name
+    validate_resource_name(name, "skill")
+
+    core = CoreRepository()
+    root, scope, scope_note = _install_root(
+        core,
+        global_scope=global_scope,
+        workspace=workspace,
+        project=project,
+    )
+    destination = root / "skills" / name
+    if destination.exists():
+        raise click.ClickException(f"Skill already exists: {scope}:{name}")
+
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    shutil.copytree(source, destination)
+    if scope_note is not None:
+        click.echo(scope_note)
+    click.echo(f"Installed {scope} skill: {name}")
+    click.echo(f"Source: {compact_home_path(source)}")
+    click.echo(f"Destination: {compact_home_path(destination)}")
+
+
+@skills.command("list", help="List global skills, or workspace skills with -w.")
+@workspace_option()
+@click.pass_obj
+def skills_list(obj: dict[str, str], workspace: str | None) -> None:
+    ui = SyncConsoleUI(Console())
+    core = CoreRepository()
+    root = workspace_config_root(core, workspace)
+    skill_sources = CoreRepository(root).list_skill_sources()
+    scope = f"workspace:{workspace}" if workspace else "global"
+    rows = [
+        [
+            source.name,
+            scope,
+            "bundle" if (source / "meta.yaml").exists() else "legacy",
+            compact_home_path(source),
+        ]
+        for source in skill_sources
+    ]
+    skill_dir = compact_home_path(root / "skills")
+    scope_message = (
+        f"No workspace skills configured for {workspace}"
+        if workspace
+        else "No global skills configured"
+    )
+    empty_message = (
+        f"{scope_message} in {skill_dir}.\n"
+        f"- Copy a skill into {skill_dir}/<name>\n"
+        "- code-agnostic plan\n"
+        "- code-agnostic apply"
+    )
+    ui.render_list(
+        "skills",
+        ["Skill", "Scope", "Format", "Source"],
+        rows,
+        empty_message,
+    )
+
+
+@skills.command("remove", help="Remove a global skill, or a workspace skill with -w.")
+@click.option("--name", required=True, help="Skill name to remove.")
+@workspace_option()
+@click.pass_obj
+def skills_remove(obj: dict[str, str], name: str, workspace: str | None) -> None:
+    validate_resource_name(name, "skill")
+    core = CoreRepository()
+    root = workspace_config_root(core, workspace)
+    skill_dir = root / "skills" / name
+    if not skill_dir.exists():
+        raise click.ClickException(f"Skill not found: {name}")
+    shutil.rmtree(skill_dir)
+    scope = f"workspace:{workspace}" if workspace else "global"
+    click.echo(f"Removed {scope} skill: {name}")

{code_agnostic-0.3.12 → code_agnostic-0.3.13}/code_agnostic/cli/commands/status.py

@@ -11,6 +11,8 @@ from code_agnostic.errors import SyncAppError
 from code_agnostic.models import (
     EditorStatusRow,
     EditorSyncStatus,
+    ProjectStatusRow,
+    ProjectSyncStatus,
     WorkspaceStatusRow,
     WorkspaceSyncStatus,
 )
@@ -70,12 +72,28 @@ def status(obj: dict[str, str], app: str, verbose: bool) -> None:
                 repos=[],
             )
         ]
+    try:
+        project_rows = status_service.build_project_status(
+            core, app_services=enabled_services
+        )
+    except SyncAppError as exc:
+        project_rows = [
+            ProjectStatusRow(
+                name="projects",
+                path=str(core.projects_path),
+                status=ProjectSyncStatus.ERROR,
+                detail=str(exc),
+            )
+        ]
     ui.render_status(
         editor_rows,
         workspace_rows,
+        project_rows,
     )
 
-    if any(row.status == EditorSyncStatus.ERROR for row in editor_rows) or any(
-        row.status == WorkspaceSyncStatus.ERROR for row in workspace_rows
+    if (
+        any(row.status == EditorSyncStatus.ERROR for row in editor_rows)
+        or any(row.status == WorkspaceSyncStatus.ERROR for row in workspace_rows)
+        or any(row.status == ProjectSyncStatus.ERROR for row in project_rows)
     ):
         raise click.exceptions.Exit(1)

code_agnostic-0.3.13/code_agnostic/core/project_repository.py

@@ -0,0 +1,10 @@
+from pathlib import Path
+
+from code_agnostic.core.workspace_repository import WorkspaceConfigRepository
+
+
+class ProjectConfigRepository(WorkspaceConfigRepository):
+    """Source repository for project-level config."""
+
+    def __init__(self, root: Path) -> None:
+        super().__init__(root)

{code_agnostic-0.3.12 → code_agnostic-0.3.13}/code_agnostic/core/repository.py

@@ -158,13 +158,24 @@ class CoreRepository(BaseSourceRepository):
     def workspaces_path(self) -> Path:
         return self.config_dir / "workspaces.json"
 
+    @property
+    def projects_path(self) -> Path:
+        return self.config_dir / "projects.json"
+
     @property
     def workspaces_dir(self) -> Path:
         return self.root / "workspaces"
 
+    @property
+    def projects_dir(self) -> Path:
+        return self.root / "projects"
+
     def workspace_config_dir(self, name: str) -> Path:
         return self.workspaces_dir / name
 
+    def project_config_dir(self, name: str) -> Path:
+        return self.projects_dir / name
+
     def load_opencode_base(self) -> dict[str, Any]:
         if not self.opencode_base_path.exists():
             return {}
@@ -251,3 +262,82 @@ class CoreRepository(BaseSourceRepository):
             return False
         self.save_workspaces(kept)
         return True
+
+    def load_projects(self) -> list[dict[str, str]]:
+        payload, error = read_json_safe(self.projects_path)
+        if error is not None:
+            raise InvalidJsonFormatError(self.projects_path, error)
+        if payload is None:
+            return []
+        if not isinstance(payload, list):
+            raise InvalidConfigSchemaError(self.projects_path, "must be a JSON array")
+
+        result: list[dict[str, str]] = []
+        seen_names: set[str] = set()
+        seen_paths: set[Path] = set()
+        for item in payload:
+            if not isinstance(item, dict):
+                raise InvalidConfigSchemaError(
+                    self.projects_path, "entries must be JSON objects"
+                )
+            name = item.get("name")
+            path = item.get("path")
+            if not isinstance(name, str) or not isinstance(path, str):
+                raise InvalidConfigSchemaError(
+                    self.projects_path, "entries must contain string name and path"
+                )
+            normalized_name = name.strip()
+            if not normalized_name:
+                raise InvalidConfigSchemaError(
+                    self.projects_path, "project name cannot be empty"
+                )
+            normalized_path = Path(path).expanduser().resolve()
+            if normalized_name in seen_names:
+                raise InvalidConfigSchemaError(
+                    self.projects_path, f"duplicate project name: {normalized_name}"
+                )
+            if normalized_path in seen_paths:
+                raise InvalidConfigSchemaError(
+                    self.projects_path, f"duplicate project path: {normalized_path}"
+                )
+            result.append({"name": normalized_name, "path": str(normalized_path)})
+            seen_names.add(normalized_name)
+            seen_paths.add(normalized_path)
+        return result
+
+    def save_projects(self, projects: list[dict[str, str]]) -> None:
+        serialized = sorted(
+            [{"name": item["name"], "path": item["path"]} for item in projects],
+            key=lambda item: item["name"].lower(),
+        )
+        write_json(self.projects_path, serialized)
+
+    def add_project(self, name: str, path: Path) -> None:
+        normalized_name = name.strip()
+        if not normalized_name:
+            raise ValueError("Project name cannot be empty")
+        normalized_path = path.expanduser().resolve()
+        if not normalized_path.exists() or not normalized_path.is_dir():
+            raise ValueError(
+                f"Project path does not exist or is not a directory: {normalized_path}"
+            )
+
+        projects = self.load_projects()
+        for item in projects:
+            if item["name"] == normalized_name:
+                raise ValueError(f"Project name already exists: {normalized_name}")
+            if Path(item["path"]) == normalized_path:
+                raise ValueError(f"Project path already exists: {normalized_path}")
+
+        projects.append({"name": normalized_name, "path": str(normalized_path)})
+        self.save_projects(projects)
+        self.project_config_dir(normalized_name).mkdir(parents=True, exist_ok=True)
+
+    def remove_project(self, name: str) -> bool:
+        target_name = name.strip()
+        projects = self.load_projects()
+        kept = [item for item in projects if item["name"] != target_name]
+        if len(kept) == len(projects):
+            return False
+        self.save_projects(kept)
+        return True