agentbundle 0.35.2__tar.gz → 0.37.2__tar.gz

{agentbundle-0.35.2/agentbundle.egg-info → agentbundle-0.37.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbundle
-Version: 0.35.2
+Version: 0.37.2
 Summary: npm for your coding agent. Install packs of skills, subagents, and hooks into any repo, for every major agent.
 Author-email: eugenelim <eugenelim@users.noreply.github.com>
 License-Expression: Apache-2.0 OR MIT
@@ -34,42 +34,49 @@ python -m pip install agentbundle
 
 Requires Python 3.11+. Runs on macOS, Linux, and Windows.
 
-## What's new in 0.35.0
+## What's new in 0.37.2
 
-**Installs now work on corporate networks that inspect TLS.** If your employer
-runs a proxy that re-signs HTTPS traffic, an install used to fail like this and
-leave you nothing to act on:
+`agentbundle catalogue verify` now performs all 19 advertised checks. It
+validates profile schemas and pack references, dependency ranges and cycles,
+adapter compatibility, generated-output drift, pack preflight metadata, and
+skill evaluation manifests. The verifier remains read-only and portable across
+external catalogues.
 
-```
-install: Failed to fetch catalogue archive: … —
-  [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed:
-  unable to get local issuer certificate
-```
+Dependency ranges now use the same npm-compatible grammar in verify, lint, and
+install: caret, tilde, comparator, compound, and prerelease forms agree across
+all three commands. In particular, caret ranges below `1.0.0` now use normal
+semver compatibility (`^0.2` does not include `0.3.x`).
 
-The certificate authority your IT team installed is in the operating system's
-trust store, and Python does not read that store on macOS. AgentBundle now
-recovers on its own:
+## Catalogue authoring
 
+New catalogue scaffolds document the guide callout contract. The bundled
+authoring reference distinguishes exact quoted wording, which stays a
+blockquote, from guidance that should render as a Starlight `note`, `tip`,
+`caution`, or `danger` aside. Existing catalogues remain unchanged until their
+scaffolded authoring reference is refreshed.
+
+## Contract discovery
+
+The bundled public contract inventory includes the strict
+`knowledge-captured-observation.schema.json` contract used by the core pack's
+project-knowledge capture handoff.
+
+You can inspect the exact public contracts bundled with the installed
+AgentBundle version without network access:
+
+```bash
+agentbundle catalogue contracts list
+agentbundle catalogue contracts show pack.schema.json
+agentbundle catalogue contracts export --output ./reference-contracts
 ```
-agentbundle: certificate verification failed for github.com;
-  retrying with operating-system trust anchors
-```
 
-Verification stays strict throughout — the retry *adds* trust anchors and never
-removes one, and no flag or environment variable can disable verification. Only
-the administrator keychain is read; your login keychain never is, because it is
-writable without administrator rights. Set `AGENTBUNDLE_NO_SYSTEM_TRUST=1` to
-opt out and see the underlying error.
-
-`AGENTBUNDLE_CA_BUNDLE` also works on `git+https://` sources now — previously
-only the `catalogue+https://` and `archive+https://` forms read it, so following
-the documentation did not help. `SSL_CERT_FILE`, `SSL_CERT_DIR`, and
-`REQUESTS_CA_BUNDLE` are honoured there too. See
-[Corporate networks](#corporate-networks) below.
-
-When a fetch still fails, the error names the likely cause and ordered next
-steps, and the request now carries a 30-second timeout so a proxy that accepts
-the connection and never answers fails instead of hanging.
+`list` and `show` are read-only. `export` writes reference copies through a
+no-follow, preflighted batch writer; those copies do not override the contracts
+AgentBundle uses for validation.
+
+Successful `agentbundle catalogue init` output points to the scaffolded
+`guides/_shared/reference/catalogue-authoring-standards.md`, contract discovery,
+and catalogue verification. JSON init output remains unchanged.
 
 **Install into a repo** — so everyone who clones it gets the pack. `core` is the flagship pack, the loop itself:
 

{agentbundle-0.35.2 → agentbundle-0.37.2}/README-pypi.md

@@ -14,42 +14,49 @@ python -m pip install agentbundle
 
 Requires Python 3.11+. Runs on macOS, Linux, and Windows.
 
-## What's new in 0.35.0
+## What's new in 0.37.2
 
-**Installs now work on corporate networks that inspect TLS.** If your employer
-runs a proxy that re-signs HTTPS traffic, an install used to fail like this and
-leave you nothing to act on:
+`agentbundle catalogue verify` now performs all 19 advertised checks. It
+validates profile schemas and pack references, dependency ranges and cycles,
+adapter compatibility, generated-output drift, pack preflight metadata, and
+skill evaluation manifests. The verifier remains read-only and portable across
+external catalogues.
 
-```
-install: Failed to fetch catalogue archive: … —
-  [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed:
-  unable to get local issuer certificate
-```
+Dependency ranges now use the same npm-compatible grammar in verify, lint, and
+install: caret, tilde, comparator, compound, and prerelease forms agree across
+all three commands. In particular, caret ranges below `1.0.0` now use normal
+semver compatibility (`^0.2` does not include `0.3.x`).
 
-The certificate authority your IT team installed is in the operating system's
-trust store, and Python does not read that store on macOS. AgentBundle now
-recovers on its own:
+## Catalogue authoring
 
+New catalogue scaffolds document the guide callout contract. The bundled
+authoring reference distinguishes exact quoted wording, which stays a
+blockquote, from guidance that should render as a Starlight `note`, `tip`,
+`caution`, or `danger` aside. Existing catalogues remain unchanged until their
+scaffolded authoring reference is refreshed.
+
+## Contract discovery
+
+The bundled public contract inventory includes the strict
+`knowledge-captured-observation.schema.json` contract used by the core pack's
+project-knowledge capture handoff.
+
+You can inspect the exact public contracts bundled with the installed
+AgentBundle version without network access:
+
+```bash
+agentbundle catalogue contracts list
+agentbundle catalogue contracts show pack.schema.json
+agentbundle catalogue contracts export --output ./reference-contracts
 ```
-agentbundle: certificate verification failed for github.com;
-  retrying with operating-system trust anchors
-```
 
-Verification stays strict throughout — the retry *adds* trust anchors and never
-removes one, and no flag or environment variable can disable verification. Only
-the administrator keychain is read; your login keychain never is, because it is
-writable without administrator rights. Set `AGENTBUNDLE_NO_SYSTEM_TRUST=1` to
-opt out and see the underlying error.
-
-`AGENTBUNDLE_CA_BUNDLE` also works on `git+https://` sources now — previously
-only the `catalogue+https://` and `archive+https://` forms read it, so following
-the documentation did not help. `SSL_CERT_FILE`, `SSL_CERT_DIR`, and
-`REQUESTS_CA_BUNDLE` are honoured there too. See
-[Corporate networks](#corporate-networks) below.
-
-When a fetch still fails, the error names the likely cause and ordered next
-steps, and the request now carries a 30-second timeout so a proxy that accepts
-the connection and never answers fails instead of hanging.
+`list` and `show` are read-only. `export` writes reference copies through a
+no-follow, preflighted batch writer; those copies do not override the contracts
+AgentBundle uses for validation.
+
+Successful `agentbundle catalogue init` output points to the scaffolded
+`guides/_shared/reference/catalogue-authoring-standards.md`, contract discovery,
+and catalogue verification. JSON init output remains unchanged.
 
 **Install into a repo** — so everyone who clones it gets the pack. `core` is the flagship pack, the loop itself:
 

{agentbundle-0.35.2 → agentbundle-0.37.2}/agentbundle/_data/catalogue-scaffold/guides/_shared/reference/catalogue-authoring-standards.md

@@ -13,6 +13,33 @@ Machine contracts in `contracts/` are normative. These guides explain how to use
 Each section below names the authoritative contract and points to the guide that
 explains it. When a guide and its contract disagree, the contract is right.
 
+## Guide asides and quotations
+
+Use a Starlight aside when a passage does work beyond the surrounding narrative.
+Choose the type by what the reader needs to do with it:
+
+| Type | Use it for |
+| --- | --- |
+| `note` | Scope, orientation, or background the reader must notice |
+| `tip` | An optional technique that improves the result or route |
+| `caution` | A pitfall, limitation, or recovery step with reversible consequences |
+| `danger` | A risk of severe or irreversible harm |
+
+Use only those four types. Keep the default visible title unless a specific title
+helps the reader act. Put the complete guidance inside the directive:
+
+```md
+:::caution
+Confirm the generated paths before replacing an existing projection.
+:::
+```
+
+A blockquote has a different job: it preserves someone else's words or exact text
+the reader must recognize, such as a prompt, transcript, sample response, or rubric
+wording. Leave those passages as `>` blockquotes. Do not turn prose into a quotation
+just to make it visually prominent, and do not turn genuine quoted wording into an
+aside.
+
 ---
 
 ## 1. Catalogue manifest
@@ -426,5 +453,7 @@ contracts used for validation by this agentbundle version.
 
 ## Journey format
 
-> **Not yet available.** Wave 4 of the catalogue-contracts initiative will define the
-> journey format and its contract. This section will be filled in when that wave ships.
+:::caution
+**Not yet available.** Wave 4 of the catalogue-contracts initiative will define the
+journey format and its contract. This section will be filled in when that wave ships.
+:::

{agentbundle-0.35.2 → agentbundle-0.37.2}/agentbundle/_data/catalogue-scaffold/manifest.json

@@ -1,6 +1,6 @@
 {
   "files": {
-    "guides/_shared/reference/catalogue-authoring-standards.md": "3217e6bfcc15dc116d40e1b327b6bf19b66212c7e13553e42966f9982b3c3487",
+    "guides/_shared/reference/catalogue-authoring-standards.md": "42d4066e9a0226337268b6ea15fdf983ba0dd5f45bfde861557c2565ea354738",
     "guides/_shared/reference/catalogue-ci-contract.md": "fae793ab47989b6dd3c731afcb0b4cda21c7d08bbe7fa40fca6d3abb3d158141",
     "packs/AGENTS.md": "9bfeda4069826e518a4f4fdae45bd40f4393c1c5aaf146149d3eb4aece30be83",
     "packs/README.md": "d2de5f9556f4c8e521103474bde74636e02cc805f9bf5312a3a61a1f3eb45d8f",
@@ -9,7 +9,7 @@
     "packs/_example/.claude-plugin/plugin.json": "7f94084a56260eed225ec47ac82042fe9029c594557cca760a459885d03ccc26",
     "packs/_example/README.md": "ef130c9c1f97a75a07cc59fc55fc5b3bf71846dd2f06c3cddf5a1154023b6ef6",
     "packs/_example/pack.toml": "f19a0be9fca99a6a0e3ce2d5cd188bf98000f0a4f186954fb42a0c99c6859701",
-    "profiles/AGENTS.md": "8950438d9e0f57c13613104c88c90b598b53196c91bfdced6d63e4e01b5e9254",
+    "profiles/AGENTS.md": "794e7f8bdccc0479cf1ac45f864e1cb829ab739b3cdd15c66baad7ee1c894329",
     "profiles/README.md": "a0b0268edc57fc575f7fea08f3363ba7da9f6e67dc4a0a6f8bd38c9668c97922",
     "profiles/_example/README.md": "164494df049ddce3e57cb44ed604cb3d39be0a6ec2072e609ea3fa4bbfc74c72",
     "profiles/_example/profile.toml": "68af18cf50fa0327a9776b029c92bb1cf82710c649691b3ac889eb8537b8eac7",

{agentbundle-0.35.2 → agentbundle-0.37.2}/agentbundle/_data/catalogue-scaffold/profiles/AGENTS.md

@@ -14,6 +14,10 @@ The profile **id** is the filename stem. It must match `^[a-z0-9][a-z0-9-]*$`.
 
 ## Current schema fields
 
+The machine source of truth for profile TOML format is
+[`contracts/profile.schema.json`](../contracts/profile.schema.json). The table
+below is a reading aid; where the two disagree, the schema wins.
+
 | Field | Required | Type | Description |
 |-------|----------|------|-------------|
 | `scope` | yes | `"repo"` or `"user"` | Installation scope |

agentbundle-0.37.2/agentbundle/_data/knowledge-captured-observation.schema.json

@@ -0,0 +1,287 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-ready-repo.example/contracts/jsonschema/knowledge-captured-observation.schema.json",
+  "title": "Knowledge captured observation",
+  "description": "Strict producer request admitted by project-knowledge capture before core derives storage identity.",
+  "x-spec": ["docs/specs/project-knowledge-foundation/"],
+  "type": "object",
+  "contract_version": "knowledge-captured-observation.v1",
+  "additionalProperties": false,
+  "required": [
+    "contract_version",
+    "lesson",
+    "kind",
+    "project_scope",
+    "competency_facets",
+    "destination_hint",
+    "producer",
+    "semantic_gate",
+    "provenance",
+    "freshness_anchor",
+    "observed_at",
+    "privacy_attestation"
+  ],
+  "properties": {
+    "contract_version": {
+      "const": "knowledge-captured-observation.v1"
+    },
+    "lesson": {
+      "$ref": "#/$defs/safeText2000"
+    },
+    "kind": {
+      "enum": ["pattern", "gotcha", "antipattern"]
+    },
+    "project_scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["paths", "audience"],
+      "properties": {
+        "paths": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 20,
+          "items": {
+            "$ref": "#/$defs/repositoryPath"
+          }
+        },
+        "audience": {
+          "const": "project"
+        }
+      }
+    },
+    "competency_facets": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 9,
+      "uniqueItems": true,
+      "items": {
+        "enum": [
+          "CQ-ORIENT",
+          "CQ-DESIGN",
+          "CQ-CHANGE",
+          "CQ-DIAGNOSE",
+          "CQ-REVIEW",
+          "CQ-VERIFY",
+          "CQ-OPERATE",
+          "CQ-ROUTE",
+          "CQ-RETIRE"
+        ]
+      }
+    },
+    "destination_hint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "path"],
+      "properties": {
+        "type": {
+          "enum": ["topic", "canonical-artifact", "route-suggestion"]
+        },
+        "path": {
+          "$ref": "#/$defs/repositoryPath"
+        }
+      }
+    },
+    "producer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workflow", "workflow_version"],
+      "properties": {
+        "workflow": {
+          "$ref": "#/$defs/slug"
+        },
+        "workflow_version": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 80,
+          "pattern": "^[A-Za-z0-9._+-]+$"
+        }
+      }
+    },
+    "semantic_gate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "artifact"],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/slug"
+        },
+        "artifact": {
+          "$ref": "#/$defs/repositoryPath"
+        }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sources"],
+      "properties": {
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 12,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path"],
+            "properties": {
+              "path": {
+                "$ref": "#/$defs/repositoryPath"
+              },
+              "line_start": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 1000000
+              },
+              "line_end": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 1000000
+              }
+            }
+          }
+        }
+      }
+    },
+    "freshness_anchor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "digest"],
+      "properties": {
+        "path": {
+          "$ref": "#/$defs/repositoryPath"
+        },
+        "digest": {
+          "$ref": "#/$defs/digest"
+        }
+      }
+    },
+    "observed_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
+    },
+    "privacy_attestation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "reviewed",
+        "contains_private_data",
+        "contains_secrets",
+        "contains_instructions"
+      ],
+      "properties": {
+        "reviewed": {
+          "const": true
+        },
+        "contains_private_data": {
+          "const": false
+        },
+        "contains_secrets": {
+          "const": false
+        },
+        "contains_instructions": {
+          "const": false
+        }
+      }
+    },
+    "friction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["failed_attempts", "summary"],
+      "properties": {
+        "failed_attempts": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 20
+        },
+        "summary": {
+          "$ref": "#/$defs/safeText500"
+        }
+      }
+    },
+    "verification_route": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["command", "path"],
+      "properties": {
+        "command": {
+          "$ref": "#/$defs/safeText500"
+        },
+        "path": {
+          "$ref": "#/$defs/repositoryPath"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "safeText2000": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000
+    },
+    "safeText500": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 500
+    },
+    "slug": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1000,
+      "pattern": "^(?:\\.|(?!/)(?![A-Za-z]:)(?!.*:)(?!.*\\\\)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*(?:^|/)(?:[Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Mm][1-9]|[Ll][Pp][Tt][1-9])(?:\\.|/|$))(?!.*[. ](?:/|$)).+)$"
+    },
+    "digest": {
+      "oneOf": [
+        {"$ref": "#/$defs/sha256BytesDigest"},
+        {"$ref": "#/$defs/gitBlobDigest"}
+      ]
+    },
+    "sha256BytesDigest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "sha256", "byte_length"],
+      "properties": {
+        "kind": {
+          "const": "sha256-bytes-v1"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "byte_length": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "gitBlobDigest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "algorithm", "object_id"],
+      "properties": {
+        "kind": {"const": "git-blob-v1"},
+        "algorithm": {"enum": ["sha1", "sha256"]},
+        "object_id": {
+          "type": "string",
+          "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$"
+        }
+      },
+      "allOf": [
+        {
+          "if": {"properties": {"algorithm": {"const": "sha1"}}},
+          "then": {"properties": {"object_id": {"pattern": "^[0-9a-f]{40}$"}}}
+        },
+        {
+          "if": {"properties": {"algorithm": {"const": "sha256"}}},
+          "then": {"properties": {"object_id": {"pattern": "^[0-9a-f]{64}$"}}}
+        }
+      ]
+    }
+  }
+}

{agentbundle-0.35.2 → agentbundle-0.37.2}/agentbundle/_data/public-contracts.txt

@@ -2,6 +2,7 @@ adapter.schema.json
 adapter.toml
 catalogue.schema.json
 guide.schema.json
+knowledge-captured-observation.schema.json
 marketplace-entry.schema.json
 pack.schema.json
 plugin-manifest.derived.schema.json

{agentbundle-0.35.2 → agentbundle-0.37.2}/agentbundle/build/adapters/claude_code.py

@@ -24,7 +24,10 @@ from typing import Iterator
 # keeps the phases predictable, which the spec calls for.
 from agentbundle.build.phase_order import PHASE_ORDER as _PHASE_ORDER
 from agentbundle.build.projection_io import copy_projected_file, ensure_directory_no_follow
-from agentbundle.build.projections.direct_directory import sweep_orphans
+from agentbundle.build.projections.direct_directory import (
+    ignore_absolute_symlinks,
+    sweep_orphans,
+)
 from agentbundle.build.projections.merge_json import project_merge_json
 
 
@@ -197,23 +200,6 @@ def _project_single(
             raise ValueError(f"claude-code: unhandled mode {mode!r} for {primitive_name}")
 
 
-def _ignore_absolute_symlinks(directory: str, names: list[str]) -> set[str]:
-    """`shutil.copytree` ignore callback: drop symlinks with absolute targets
-    and Python bytecode cache directories.
-
-    Relative symlinks (intra-skill cross-references) are preserved as
-    symlinks. Absolute symlinks always escape the tree and are a path-escape
-    vector. __pycache__ directories are excluded because .pyc files embed
-    absolute source paths and can never be byte-identical across machines.
-    """
-    base = Path(directory)
-    return {
-        name for name in names
-        if name == "__pycache__"
-        or ((base / name).is_symlink() and (base / name).readlink().is_absolute())
-    }
-
-
 def _project_direct_directory(source_dir: Path, target_dir: Path) -> None:
     for entry in sorted(source_dir.iterdir()):
         # Defense-in-depth — `lint-packs` rejects packs that ship
@@ -233,11 +219,11 @@ def _project_direct_directory(source_dir: Path, target_dir: Path) -> None:
             elif destination.exists():
                 shutil.rmtree(destination)
             # symlinks=True preserves relative nested symlinks; absolute
-            # targets are filtered out by _ignore_absolute_symlinks.
+            # targets are filtered out by ignore_absolute_symlinks.
             shutil.copytree(
                 entry, destination,
                 symlinks=True,
-                ignore=_ignore_absolute_symlinks,
+                ignore=ignore_absolute_symlinks,
             )
 
 

{agentbundle-0.35.2 → agentbundle-0.37.2}/agentbundle/build/adapters/codex.py

@@ -25,7 +25,10 @@ from agentbundle.build.projection_io import copy_projected_file, ensure_director
 from agentbundle.build.projections.codex_agent_toml import (
     project_codex_agent_toml,
 )
-from agentbundle.build.projections.direct_directory import sweep_orphans
+from agentbundle.build.projections.direct_directory import (
+    ignore_absolute_symlinks,
+    sweep_orphans,
+)
 from agentbundle.build.projections.merge_json import project_merge_json
 
 
@@ -181,11 +184,11 @@ def project_packs(
                         elif destination.exists():
                             shutil.rmtree(destination)
                         # symlinks=True preserves relative nested symlinks;
-                        # absolute targets are filtered by _ignore_absolute_symlinks.
+                        # absolute targets are filtered by ignore_absolute_symlinks.
                         shutil.copytree(
                             entry, destination,
                             symlinks=True,
-                            ignore=_ignore_absolute_symlinks,
+                            ignore=ignore_absolute_symlinks,
                         )
             # Bound to `skill` only per spec § Never do. Other
             # direct-directory primitives opt in explicitly.
@@ -212,23 +215,6 @@ def project_packs(
             raise ValueError(f"codex: unhandled mode {mode!r} for {primitive_name}")
 
 
-def _ignore_absolute_symlinks(directory: str, names: list[str]) -> set[str]:
-    """`shutil.copytree` ignore callback: drop symlinks with absolute targets
-    and Python bytecode cache directories.
-
-    Relative symlinks (intra-skill cross-references) are preserved.
-    Absolute symlinks always escape the tree and are a path-escape vector.
-    __pycache__ directories are excluded because .pyc files embed absolute
-    source paths and can never be byte-identical across machines.
-    """
-    base = Path(directory)
-    return {
-        name for name in names
-        if name == "__pycache__"
-        or ((base / name).is_symlink() and (base / name).readlink().is_absolute())
-    }
-
-
 def _project_direct_file(
     source_dir: Path,
     output_root: Path,