code-agnostic 0.3.9__tar.gz → 0.3.10__tar.gz

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-agnostic
-Version: 0.3.9
+Version: 0.3.10
 Summary: Centralized hub for LLM coding config: MCP, skills, rules, and agents.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -19,6 +19,8 @@ Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: jsonschema>=4.0; extra == "dev"
 Requires-Dist: ruff>=0.8.0; extra == "dev"
 Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: types-jsonschema>=4.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0; extra == "dev"
 Dynamic: license-file
 
 # code-agnostic
@@ -62,6 +64,21 @@ Legacy single-file rules, `skills/<name>/SKILL.md`, and markdown agents are stil
 
 Today the implementation is still mixed: some assets are compiled and some are symlinked. The active migration plan is to move to generated outputs everywhere with a strict compiler contract instead of implicit per-app behavior.
 
+## Scope model
+
+`code-agnostic` has two managed source scopes today:
+
+- 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.
+
+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.
+
 ## Install
 
 ```bash
@@ -115,7 +132,7 @@ code-agnostic apply
 | Native repo config include for workspace `AGENTS.md` | yes | -- | -- | -- |
 | Repo/subdir gets shared workspace instructions today | yes | -- | yes | yes |
 | Nested `AGENTS.md` discovery | -- | yes | yes | -- |
-| Workspace propagation | yes | -- | yes | yes |
+| Workspace propagation | yes | yes | yes | yes |
 | Import from | yes | yes | yes | yes |
 | Interactive import (TUI) | yes | yes | yes | yes |
 
@@ -123,11 +140,11 @@ code-agnostic apply
 target-specific or lossy; run `code-agnostic explain-lossiness` to see fields
 that are omitted or rejected for a selected target.
 
-Cursor workspace propagation is intentionally disabled to avoid duplicate MCP initialization in multi-root workspaces: https://forum.cursor.com/t/mcp-multi-root-workspace-causes-duplicate-mcp-server-initialization-4x-createclient-actions/144003
+Cursor workspace propagation writes repo-local MCP, skills, and agents when those resources exist in the workspace source config.
 
 OpenCode workspace configs include the shared workspace `AGENTS.md` natively via `instructions`, so repos under the workspace get both repo-local and shared workspace instructions. Codex repos receive workspace instructions through a generated `AGENTS.override.md`, which is added to each repo's `.git/info/exclude`. Claude Code receives workspace instructions through generated `CLAUDE.local.md` files, never by editing committed `CLAUDE.md`.
 
-Cursor documents `AGENTS.md` support in project roots and subdirectories. `code-agnostic` still disables Cursor workspace propagation, so it does not copy or link the shared workspace `AGENTS.md` into child repos; Cursor will load repo-local or nested `AGENTS.md` files that already exist in the opened project. Codex documents nested `AGENTS.md` discovery, but not a native config include for an extra workspace file.
+Cursor documents `AGENTS.md` support in project roots and subdirectories. `code-agnostic` does not copy or link the shared workspace `AGENTS.md` into child repos; Cursor will load repo-local or nested `AGENTS.md` files that already exist in the opened project. Codex documents nested `AGENTS.md` discovery, but not a native config include for an extra workspace file.
 
 ## Features
 
@@ -139,10 +156,15 @@ Plan-then-apply workflow. Preview every change before it touches disk.
 code-agnostic validate              # check canonical source files
 code-agnostic plan -a cursor        # dry-run for one editor
 code-agnostic plan                   # dry-run for all
-code-agnostic apply                  # apply changes
-code-agnostic status                 # check drift
+code-agnostic apply                  # apply changes for all enabled editors
+code-agnostic status                 # check drift and disabled app states
+code-agnostic explain-lossiness      # show fields omitted or rejected per editor
 ```
 
+Bare `plan` and `apply` target every enabled editor; bare `status` also shows
+disabled app states. Use `-a codex`, `-a cursor`, `-a opencode`, or `-a claude`
+when you want one editor at a time.
+
 If managed outputs need repair after an apply, restore the active synced revision:
 
 ```bash
@@ -230,9 +252,9 @@ That command should copy the skill into the source of truth and then run the nor
 
 ### Workspaces
 
-Register workspace directories. Workspace rules are compiled into a canonical `AGENTS.md` at the workspace root. Repos keep their own repo-specific `AGENTS.md`; Codex receives the workspace rules through generated, git-excluded `AGENTS.override.md` files, while OpenCode workspace configs reference the shared workspace file through `instructions`. Claude receives generated `CLAUDE.local.md` files and project MCP entries in `~/.claude.json["projects"][absolute_repo_path]["mcpServers"]`. Repo-local app config, skills, and agents are propagated for OpenCode, Codex, and Claude.
+Register workspace directories. Workspace rules are compiled into a canonical `AGENTS.md` at the workspace root. Repos keep their own repo-specific `AGENTS.md`; Codex receives the workspace rules through generated, git-excluded `AGENTS.override.md` files, while OpenCode workspace configs reference the shared workspace file through `instructions`. Claude receives generated `CLAUDE.local.md` files and project MCP entries in `~/.claude.json["projects"][absolute_repo_path]["mcpServers"]`. Workspace source config, skills, and agents are propagated into repo-local generated paths for OpenCode, Cursor, Codex, and Claude; user-created project-local skill folders remain unmanaged until project-scoped installs are supported.
 
-`.cursor` workspace propagation is intentionally disabled to avoid duplicate MCP initialization when opening multi-root workspaces in Cursor (related issue: https://forum.cursor.com/t/mcp-multi-root-workspace-causes-duplicate-mcp-server-initialization-4x-createclient-actions/144003).
+Cursor propagation intentionally stays to repo-local MCP, skills, and agents; it does not copy the shared workspace `AGENTS.md` into child repos.
 
 ```bash
 code-agnostic workspaces add --name myproject --path ~/code/myproject
@@ -262,6 +284,12 @@ code-agnostic import apply -a cursor --include mcp --on-conflict overwrite
 code-agnostic import plan -a codex -i    # interactive TUI picker
 ```
 
+`import plan` previews what will be copied into the hub; `import apply` writes
+only the selected sections. Conflicts are skipped by default, so rerun with
+`--on-conflict overwrite` only after reviewing the preview. Use `--include`,
+`--exclude`, `--source-root`, and `--follow-symlinks` to narrow what gets
+imported.
+
 ### CLI conventions
 
 All commands use named flags (`-a`, `-w`, `-v`). Singular aliases work too: `app` = `apps`, `workspace` = `workspaces`.

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/README.md

@@ -39,6 +39,21 @@ Legacy single-file rules, `skills/<name>/SKILL.md`, and markdown agents are stil
 
 Today the implementation is still mixed: some assets are compiled and some are symlinked. The active migration plan is to move to generated outputs everywhere with a strict compiler contract instead of implicit per-app behavior.
 
+## Scope model
+
+`code-agnostic` has two managed source scopes today:
+
+- 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.
+
+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.
+
 ## Install
 
 ```bash
@@ -92,7 +107,7 @@ code-agnostic apply
 | Native repo config include for workspace `AGENTS.md` | yes | -- | -- | -- |
 | Repo/subdir gets shared workspace instructions today | yes | -- | yes | yes |
 | Nested `AGENTS.md` discovery | -- | yes | yes | -- |
-| Workspace propagation | yes | -- | yes | yes |
+| Workspace propagation | yes | yes | yes | yes |
 | Import from | yes | yes | yes | yes |
 | Interactive import (TUI) | yes | yes | yes | yes |
 
@@ -100,11 +115,11 @@ code-agnostic apply
 target-specific or lossy; run `code-agnostic explain-lossiness` to see fields
 that are omitted or rejected for a selected target.
 
-Cursor workspace propagation is intentionally disabled to avoid duplicate MCP initialization in multi-root workspaces: https://forum.cursor.com/t/mcp-multi-root-workspace-causes-duplicate-mcp-server-initialization-4x-createclient-actions/144003
+Cursor workspace propagation writes repo-local MCP, skills, and agents when those resources exist in the workspace source config.
 
 OpenCode workspace configs include the shared workspace `AGENTS.md` natively via `instructions`, so repos under the workspace get both repo-local and shared workspace instructions. Codex repos receive workspace instructions through a generated `AGENTS.override.md`, which is added to each repo's `.git/info/exclude`. Claude Code receives workspace instructions through generated `CLAUDE.local.md` files, never by editing committed `CLAUDE.md`.
 
-Cursor documents `AGENTS.md` support in project roots and subdirectories. `code-agnostic` still disables Cursor workspace propagation, so it does not copy or link the shared workspace `AGENTS.md` into child repos; Cursor will load repo-local or nested `AGENTS.md` files that already exist in the opened project. Codex documents nested `AGENTS.md` discovery, but not a native config include for an extra workspace file.
+Cursor documents `AGENTS.md` support in project roots and subdirectories. `code-agnostic` does not copy or link the shared workspace `AGENTS.md` into child repos; Cursor will load repo-local or nested `AGENTS.md` files that already exist in the opened project. Codex documents nested `AGENTS.md` discovery, but not a native config include for an extra workspace file.
 
 ## Features
 
@@ -116,10 +131,15 @@ Plan-then-apply workflow. Preview every change before it touches disk.
 code-agnostic validate              # check canonical source files
 code-agnostic plan -a cursor        # dry-run for one editor
 code-agnostic plan                   # dry-run for all
-code-agnostic apply                  # apply changes
-code-agnostic status                 # check drift
+code-agnostic apply                  # apply changes for all enabled editors
+code-agnostic status                 # check drift and disabled app states
+code-agnostic explain-lossiness      # show fields omitted or rejected per editor
 ```
 
+Bare `plan` and `apply` target every enabled editor; bare `status` also shows
+disabled app states. Use `-a codex`, `-a cursor`, `-a opencode`, or `-a claude`
+when you want one editor at a time.
+
 If managed outputs need repair after an apply, restore the active synced revision:
 
 ```bash
@@ -207,9 +227,9 @@ That command should copy the skill into the source of truth and then run the nor
 
 ### Workspaces
 
-Register workspace directories. Workspace rules are compiled into a canonical `AGENTS.md` at the workspace root. Repos keep their own repo-specific `AGENTS.md`; Codex receives the workspace rules through generated, git-excluded `AGENTS.override.md` files, while OpenCode workspace configs reference the shared workspace file through `instructions`. Claude receives generated `CLAUDE.local.md` files and project MCP entries in `~/.claude.json["projects"][absolute_repo_path]["mcpServers"]`. Repo-local app config, skills, and agents are propagated for OpenCode, Codex, and Claude.
+Register workspace directories. Workspace rules are compiled into a canonical `AGENTS.md` at the workspace root. Repos keep their own repo-specific `AGENTS.md`; Codex receives the workspace rules through generated, git-excluded `AGENTS.override.md` files, while OpenCode workspace configs reference the shared workspace file through `instructions`. Claude receives generated `CLAUDE.local.md` files and project MCP entries in `~/.claude.json["projects"][absolute_repo_path]["mcpServers"]`. Workspace source config, skills, and agents are propagated into repo-local generated paths for OpenCode, Cursor, Codex, and Claude; user-created project-local skill folders remain unmanaged until project-scoped installs are supported.
 
-`.cursor` workspace propagation is intentionally disabled to avoid duplicate MCP initialization when opening multi-root workspaces in Cursor (related issue: https://forum.cursor.com/t/mcp-multi-root-workspace-causes-duplicate-mcp-server-initialization-4x-createclient-actions/144003).
+Cursor propagation intentionally stays to repo-local MCP, skills, and agents; it does not copy the shared workspace `AGENTS.md` into child repos.
 
 ```bash
 code-agnostic workspaces add --name myproject --path ~/code/myproject
@@ -239,6 +259,12 @@ code-agnostic import apply -a cursor --include mcp --on-conflict overwrite
 code-agnostic import plan -a codex -i    # interactive TUI picker
 ```
 
+`import plan` previews what will be copied into the hub; `import apply` writes
+only the selected sections. Conflicts are skipped by default, so rerun with
+`--on-conflict overwrite` only after reviewing the preview. Use `--include`,
+`--exclude`, `--source-root`, and `--follow-symlinks` to narrow what gets
+imported.
+
 ### CLI conventions
 
 All commands use named flags (`-a`, `-w`, `-v`). Singular aliases work too: `app` = `apps`, `workspace` = `workspaces`.

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/code_agnostic/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "0.3.9"
+__version__ = "0.3.10"

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/code_agnostic/__main__.py

@@ -16,6 +16,7 @@ from code_agnostic.cli.commands.skills import skills
 from code_agnostic.cli.commands.status import status
 from code_agnostic.cli.commands.validate import validate
 from code_agnostic.cli.commands.workspaces import workspaces
+from code_agnostic.errors import SyncAppError
 
 
 @click.group(
@@ -52,6 +53,9 @@ def main() -> int:
     except click.exceptions.Exit as exc:
         code = exc.exit_code
         return code if isinstance(code, int) else 1
+    except SyncAppError as exc:
+        click.ClickException(str(exc)).show()
+        return 2
     except click.ClickException as exc:
         exc.show()
         return 2

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/code_agnostic/agents/codex.py

@@ -69,10 +69,13 @@ def serialize_codex_agent(agent: Agent) -> str:
     description = agent.metadata.description or agent.metadata.name or agent.name
 
     doc = tomlkit.document()
-    doc.add("name", agent.metadata.name or agent.name)
-    doc.add("description", description)
+    doc.add("name", tomlkit.item(agent.metadata.name or agent.name))
+    doc.add("description", tomlkit.item(description))
     if agent.metadata.nickname_candidates:
-        doc.add("nickname_candidates", list(agent.metadata.nickname_candidates))
+        doc.add(
+            "nickname_candidates",
+            tomlkit.item(list(agent.metadata.nickname_candidates)),
+        )
     model = agent.metadata.effective_value("codex", "model")
     if model:
         doc.add("model", model)

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/code_agnostic/apps/app_id.py

@@ -63,7 +63,7 @@ APP_CATALOG: dict[AppId, AppMetadata] = {
         toggleable=True,
         importable=True,
         supports_import_agents=True,
-        supports_workspace_propagation=False,
+        supports_workspace_propagation=True,
         project_dir_name=CURSOR_PROJECT_DIRNAME,
         config_filename=CURSOR_CONFIG_FILENAME,
     ),

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/code_agnostic/apps/claude/service.py

@@ -8,10 +8,6 @@ from code_agnostic.agents.parser import parse_agent
 from code_agnostic.apps.app_id import AppId, app_label
 from code_agnostic.apps.claude.config_repository import ClaudeConfigRepository
 from code_agnostic.apps.claude.mapper import ClaudeMCPMapper
-from code_agnostic.apps.common.compiled_planning import (
-    find_replaceable_symlink_ancestor,
-    plan_owned_compiled_text_action,
-)
 from code_agnostic.apps.common.framework import RegisteredAppConfigService
 from code_agnostic.apps.common.interfaces.mapper import IAppMCPMapper
 from code_agnostic.apps.common.interfaces.repositories import IAppConfigRepository
@@ -135,7 +131,7 @@ class ClaudeConfigService(RegisteredAppConfigService):
         removable_links: list[Path],
     ) -> tuple[list[Action], list[Path], list[str]]:
         compiler = ClaudeSkillCompiler()
-        return self._plan_owned_text_actions(
+        return self._plan_compiled_text_actions(
             sources=sources,
             target_dir=target_dir,
             scope=scope,
@@ -173,7 +169,7 @@ class ClaudeConfigService(RegisteredAppConfigService):
             agent = parse_agent(source)
             return claude_agent_target_path(target_dir, agent), compiler.compile(agent)
 
-        return self._plan_owned_text_actions(
+        return self._plan_compiled_text_actions(
             sources=sources,
             target_dir=target_dir,
             scope=scope,
@@ -186,63 +182,3 @@ class ClaudeConfigService(RegisteredAppConfigService):
             update_detail="update compiled claude agent",
             conflict_message="Claude agent sync skipped (conflict): {target}",
         )
-
-    def _plan_owned_text_actions(
-        self,
-        *,
-        sources: list[Path],
-        target_dir: Path,
-        scope: str,
-        app: str,
-        managed_paths: list[Path],
-        removable_links: list[Path],
-        compile_source,
-        create_detail: str,
-        noop_detail: str,
-        update_detail: str,
-        conflict_message: str,
-    ) -> tuple[list[Action], list[Path], list[str]]:
-        managed_path_set = {path.resolve(strict=False) for path in managed_paths}
-        removable_link_set = {path.resolve(strict=False) for path in removable_links}
-        actions: list[Action] = []
-        desired_paths: list[Path] = []
-        skipped: list[str] = []
-        scheduled_removals: set[Path] = set()
-
-        for source in sources:
-            target, payload = compile_source(source)
-            desired_paths.append(target)
-            replaceable_symlink = find_replaceable_symlink_ancestor(target, target_dir)
-            if (
-                replaceable_symlink is not None
-                and replaceable_symlink not in scheduled_removals
-            ):
-                scheduled_removals.add(replaceable_symlink)
-                removable_link_set.add(replaceable_symlink.resolve(strict=False))
-                actions.append(
-                    Action(
-                        kind=ActionKind.REMOVE_SYMLINK,
-                        path=replaceable_symlink,
-                        status=ActionStatus.REMOVE,
-                        detail=f"replace compiled {scope} symlink",
-                        app=app,
-                        scope=scope,
-                    )
-                )
-            action = plan_owned_compiled_text_action(
-                target=target,
-                payload=payload,
-                managed_paths=managed_path_set,
-                removable_link_paths=removable_link_set,
-                managed_root=target_dir,
-                scope=scope,
-                app=app,
-                create_detail=create_detail,
-                noop_detail=noop_detail,
-                update_detail=update_detail,
-            )
-            actions.append(action)
-            if action.status == ActionStatus.CONFLICT:
-                skipped.append(conflict_message.format(target=target))
-
-        return actions, desired_paths, skipped

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/code_agnostic/apps/codex/schema.json

@@ -355,6 +355,22 @@
       },
       "type": "object"
     },
+    "CodeModeConfigToml": {
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "excluded_tool_namespaces": {
+          "description": "Exact tool namespaces to omit from the code-mode nested tool surface.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "ConfigProfile": {
       "additionalProperties": false,
       "description": "Collection of common configuration options that a user can define as a unit in `config.toml`.",
@@ -410,7 +426,7 @@
               "type": "boolean"
             },
             "code_mode": {
-              "type": "boolean"
+              "$ref": "#/definitions/FeatureToml_for_CodeModeConfigToml"
             },
             "code_mode_only": {
               "type": "boolean"
@@ -556,9 +572,6 @@
             "request_rule": {
               "type": "boolean"
             },
-            "responses_websocket_response_processed": {
-              "type": "boolean"
-            },
             "responses_websockets": {
               "type": "boolean"
             },
@@ -601,6 +614,9 @@
             "terminal_resize_reflow": {
               "type": "boolean"
             },
+            "terminal_visualization_instructions": {
+              "type": "boolean"
+            },
             "tool_call_mcp_elicitation": {
               "type": "boolean"
             },
@@ -830,6 +846,16 @@
         }
       ]
     },
+    "FeatureToml_for_CodeModeConfigToml": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "$ref": "#/definitions/CodeModeConfigToml"
+        }
+      ]
+    },
     "FeatureToml_for_MultiAgentV2ConfigToml": {
       "anyOf": [
         {
@@ -2480,15 +2506,8 @@
       "type": "string"
     },
     "ReasoningEffort": {
-      "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
-      "enum": [
-        "none",
-        "minimal",
-        "low",
-        "medium",
-        "high",
-        "xhigh"
-      ],
+      "description": "A non-empty reasoning effort value advertised by the model.",
+      "minLength": 1,
       "type": "string"
     },
     "ReasoningSummary": {
@@ -4533,7 +4552,7 @@
           "type": "boolean"
         },
         "code_mode": {
-          "type": "boolean"
+          "$ref": "#/definitions/FeatureToml_for_CodeModeConfigToml"
         },
         "code_mode_only": {
           "type": "boolean"
@@ -4679,9 +4698,6 @@
         "request_rule": {
           "type": "boolean"
         },
-        "responses_websocket_response_processed": {
-          "type": "boolean"
-        },
         "responses_websockets": {
           "type": "boolean"
         },
@@ -4724,6 +4740,9 @@
         "terminal_resize_reflow": {
           "type": "boolean"
         },
+        "terminal_visualization_instructions": {
+          "type": "boolean"
+        },
         "tool_call_mcp_elicitation": {
           "type": "boolean"
         },

code_agnostic-0.3.10/code_agnostic/apps/common/compiled_planning.py

@@ -0,0 +1,115 @@
+from pathlib import Path
+
+from code_agnostic.generated_artifacts import (
+    ArtifactKind,
+    GeneratedArtifact,
+    OwnershipPolicy,
+    plan_generated_artifact,
+)
+from code_agnostic.models import Action
+
+
+def find_replaceable_symlink_ancestor(target: Path, managed_root: Path) -> Path | None:
+    current = target
+    while True:
+        if current.is_symlink() and (
+            current == managed_root or current.is_relative_to(managed_root)
+        ):
+            return current
+        if current.parent == current:
+            return None
+        current = current.parent
+
+
+def plan_compiled_text_action(
+    *,
+    target: Path,
+    payload: str,
+    managed_paths: set[Path],
+    removable_link_paths: set[Path] | None = None,
+    managed_root: Path | None = None,
+    scope: str,
+    app: str,
+    create_detail: str,
+    noop_detail: str,
+    update_detail: str,
+    conflict_detail: str = "non-managed path exists",
+) -> Action:
+    return _plan_text_action(
+        ownership=OwnershipPolicy.MANAGED_REPLACE,
+        target=target,
+        payload=payload,
+        managed_paths=managed_paths,
+        removable_link_paths=removable_link_paths,
+        managed_root=managed_root,
+        scope=scope,
+        app=app,
+        create_detail=create_detail,
+        noop_detail=noop_detail,
+        update_detail=update_detail,
+        conflict_detail=conflict_detail,
+    )
+
+
+def plan_owned_compiled_text_action(
+    *,
+    target: Path,
+    payload: str,
+    managed_paths: set[Path],
+    removable_link_paths: set[Path] | None = None,
+    managed_root: Path | None = None,
+    scope: str,
+    app: str,
+    create_detail: str,
+    noop_detail: str,
+    update_detail: str,
+    conflict_detail: str = "non-managed path exists",
+) -> Action:
+    return _plan_text_action(
+        ownership=OwnershipPolicy.OWNED_ONLY,
+        target=target,
+        payload=payload,
+        managed_paths=managed_paths,
+        removable_link_paths=removable_link_paths,
+        managed_root=managed_root,
+        scope=scope,
+        app=app,
+        create_detail=create_detail,
+        noop_detail=noop_detail,
+        update_detail=update_detail,
+        conflict_detail=conflict_detail,
+    )
+
+
+def _plan_text_action(
+    *,
+    ownership: OwnershipPolicy,
+    target: Path,
+    payload: str,
+    managed_paths: set[Path],
+    removable_link_paths: set[Path] | None,
+    managed_root: Path | None,
+    scope: str,
+    app: str,
+    create_detail: str,
+    noop_detail: str,
+    update_detail: str,
+    conflict_detail: str,
+) -> Action:
+    return plan_generated_artifact(
+        GeneratedArtifact(
+            path=target,
+            kind=ArtifactKind.TEXT,
+            payload=payload,
+            ownership=ownership,
+            managed_root=managed_root,
+            scope=scope,
+            app=app,
+            create_detail=create_detail,
+            noop_detail=noop_detail,
+            update_detail=update_detail,
+            conflict_detail=conflict_detail,
+        ),
+        managed_paths=managed_paths,
+        removable_link_paths=removable_link_paths,
+    )

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/code_agnostic/apps/common/interfaces/repositories.py

@@ -20,6 +20,16 @@ class IAppConfigRepository(ABC):
     def config_path(self) -> Path:
         raise NotImplementedError
 
+    @property
+    @abstractmethod
+    def skills_dir(self) -> Path:
+        raise NotImplementedError
+
+    @property
+    @abstractmethod
+    def agents_dir(self) -> Path:
+        raise NotImplementedError
+
     @abstractmethod
     def load_config(self) -> dict[str, Any]:
         raise NotImplementedError

{code_agnostic-0.3.9 → code_agnostic-0.3.10}/code_agnostic/apps/common/interfaces/service.py

@@ -6,7 +6,6 @@ from typing import Any
 from code_agnostic.apps.app_id import AppId, app_scope
 from code_agnostic.apps.common.compiled_planning import (
     find_replaceable_symlink_ancestor,
-    plan_compiled_text_action,
 )
 from code_agnostic.apps.common.interfaces.mapper import IAppMCPMapper
 from code_agnostic.apps.common.interfaces.repositories import IAppConfigRepository
@@ -18,6 +17,12 @@ from code_agnostic.apps.common.symlink_planning import (
     plan_stale_files_group,
     plan_stale_group,
 )
+from code_agnostic.generated_artifacts import (
+    ArtifactKind,
+    GeneratedArtifact,
+    OwnershipPolicy,
+    plan_generated_artifact,
+)
 from code_agnostic.models import Action, ActionKind, ActionStatus, SyncPlan
 
 
@@ -92,7 +97,10 @@ class IAppConfigService(ABC):
         raise NotImplementedError
 
     def agent_action_removable_links(self, removable_links: list[Path]) -> list[Path]:
-        return []
+        return removable_links
+
+    def compiled_resource_ownership_policy(self) -> OwnershipPolicy:
+        return OwnershipPolicy.OWNED_ONLY
 
     @staticmethod
     def _normalize_managed_group(value: Any) -> dict[str, Any]:
@@ -119,14 +127,18 @@ class IAppConfigService(ABC):
         desired_paths: list[Path] = []
         skipped: list[str] = []
         scheduled_removals: set[Path] = set()
+        ownership = self.compiled_resource_ownership_policy()
 
         for source in sources:
             target, payload = compile_source(source)
             desired_paths.append(target)
             replaceable_symlink = find_replaceable_symlink_ancestor(target, target_dir)
-            if (
-                replaceable_symlink is not None
-                and replaceable_symlink not in scheduled_removals
+            can_replace_symlink = replaceable_symlink is not None and (
+                ownership != OwnershipPolicy.OWNED_ONLY
+                or replaceable_symlink.resolve(strict=False) in removable_link_set
+            )
+            if replaceable_symlink is not None and (
+                can_replace_symlink and replaceable_symlink not in scheduled_removals
             ):
                 scheduled_removals.add(replaceable_symlink)
                 removable_link_set.add(replaceable_symlink.resolve(strict=False))
@@ -140,17 +152,21 @@ class IAppConfigService(ABC):
                         scope=scope,
                     )
                 )
-            action = plan_compiled_text_action(
-                target=target,
-                payload=payload,
+            action = plan_generated_artifact(
+                GeneratedArtifact(
+                    path=target,
+                    kind=ArtifactKind.TEXT,
+                    payload=payload,
+                    ownership=ownership,
+                    managed_root=target_dir,
+                    scope=scope,
+                    app=app,
+                    create_detail=create_detail,
+                    noop_detail=noop_detail,
+                    update_detail=update_detail,
+                ),
                 managed_paths=managed_path_set,
                 removable_link_paths=removable_link_set,
-                managed_root=target_dir,
-                scope=scope,
-                app=app,
-                create_detail=create_detail,
-                noop_detail=noop_detail,
-                update_detail=update_detail,
             )
             actions.append(action)
             if action.status == ActionStatus.CONFLICT: