From 9d0849bb22ff43beaf78ea4ac27139acbd111153 Mon Sep 17 00:00:00 2001 From: "facility-bot[app]" Date: Mon, 14 Sep 2026 18:55:02 +0000 Subject: [PATCH] Update Facility .NET repository conventions --- .agents/skills/dotnet-inspect/SKILL.md | 8 ++++---- apm.lock.yaml | 6 +++--- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/.agents/skills/dotnet-inspect/SKILL.md b/.agents/skills/dotnet-inspect/SKILL.md index ea22a35..c446b35 100644 --- a/.agents/skills/dotnet-inspect/SKILL.md +++ b/.agents/skills/dotnet-inspect/SKILL.md @@ -25,19 +25,19 @@ Run `dnx dotnet-inspect -y -- `. `-y` skips interactive confirmation, a | Compare APIs or method bodies | `diff --package Foo@old..new --breaking` (`--additive` new APIs; `--alloc-regressions` for allocation regressions); `match Type.MethodA Type.MethodB --package Foo --body` adds C#/IL body differences to the structural result; `match Type.Method --similar --package Foo` ranks structural candidates for discovery. | | Trace API evolution | `timeline --package Foo@old..new --type Type --members --at all`; omit `--at` to inspect the vector without acquiring packages. | | Inspect packages | `package Foo`; use `-D` to discover sections and `-S "Signals,Audit: Findings"` to audit text-bearing files and SourceLink mappings. Load `skill private-feeds` for custom/authenticated sources. | -| Inspect a Workspace | `workspace --package Foo@version --tfm net10.0`; repeat `--package` to compose ordered package Roots. Exact duplicates coalesce; packages without compile assemblies remain members. Use `--root-request TOKEN` instead to reopen the exact Root a `find --literal` result names; it is refused rather than approximated by package id and version. | +| Inspect a Workspace | `workspace --package Foo@version --tfm net10.0`; repeat `--package` to compose ordered Package occurrences. Exact duplicates coalesce; packages without compile assemblies remain members. Add `--active-package N` for structural hierarchy, Library asset IDs, Type/Member inventory, lenses, and diagnostics. Use `--root-request TOKEN` instead to reopen the exact Root a `find --literal` result names; it is refused rather than approximated by package id and version. | | Inspect libraries | `library Foo` or `library path/to.dll`; use `-D` to discover sections and `-S "Unsafe Members"` for standalone unsafe evidence. Load `skill metadata` for raw ECMA-335 tables/heaps. | -| Dependencies and relationships | `dependency-evidence --package Foo --tfm net10.0` for direct declarations; `depends Type`, `extensions Type`, or `implements Interface` for traversed relationships. Load `skill relationships` for scopes and semantics. | +| Dependencies and relationships | `depends --package Foo@version --tfm net10.0` for a package graph plus declaration evidence; add `-S Dependencies` for evidence only. Use `depends Type`, `extensions Type`, or `implements Interface` for type relationships. Load `skill relationships` for scopes and semantics. | ## Member lookup -Run `find Name` when scope is unknown, inspect the type, then `-S "Member Index"` to list overloads. Select with `Name:N` (1-based) or `Name~digest` (stable). A selected overload -defaults to `Signature`. A fully-qualified `Namespace.Type.Member` needs no scope. +Run `find Name` when scope is unknown, inspect the type, then `-S "Member Index"` to list overloads. Select with `Name:N` (1-based) or `Name~digest` (stable). A selected overload defaults to `Signature`. A fully-qualified `Namespace.Type.Member` needs no scope. ## Tips - `package` and `library` produce terse, token-efficient, high-value domain content by default. Output supports Markdown, tables, TSV, JSONL, and JSON; load `dotnet-inspect skill query` for discovery, selection, projection, and limits. - Add `--project ` when project-referenced packages should be in scope; it reads existing restored assets, so restore/build first if dependencies changed. +- `workspace` never selects an occurrence implicitly. Copy a Library asset ID, Type full name, and optional Member stable selector from `workspace --active-package N`, then add `--lens type.*` or `--lens member.*` for one exact stateless descendant request. Selector failures remain structured; JSON/JSONL retain Library asset ancestry and Member containing-versus-declaring Type joins. - Common BCL types resolve without scope: `type string`, `type 'List'`. Quote generics and patterns: `member 'Dictionary'`, `-S "Async*"`. - Unpinned packages use latest stable; add `--preview` for prerelease APIs. diff --git a/apm.lock.yaml b/apm.lock.yaml index 32d6a85..95a1d54 100644 --- a/apm.lock.yaml +++ b/apm.lock.yaml @@ -1,5 +1,5 @@ lockfile_version: '1' -generated_at: '2026-09-09T17:20:45.372303+00:00' +generated_at: '2026-09-14T18:55:02.630943+00:00' apm_version: 0.14.0 dependencies: - repo_url: Faithlife/RepoConventions @@ -13,10 +13,10 @@ dependencies: content_hash: sha256:6e4dc45d96d7adc8f1d3e3300d9ee90eef9c2d0231ea83ad86fed64fca105034 - repo_url: richlander/dotnet-inspect host: github.com - resolved_commit: aa238dd79750edc68d2213e30eb01a74260b68e2 + resolved_commit: aec46351de1bfb84c5053d2c00a34542b3a4ff91 virtual_path: skills/dotnet-inspect is_virtual: true package_type: claude_skill deployed_files: - .agents/skills/dotnet-inspect - content_hash: sha256:0c7cc502e53f4cd4666e862b29146306f080462d42b08917c8bc93e348e01931 + content_hash: sha256:b813eb759009392c278fdaf03a1f1d252f5fa163c6b0862c4b51d5080118d476