From ecf7e19e20e95e9f7e43f93775ba7936320b38b8 Mon Sep 17 00:00:00 2001 From: "facility-bot[app]" Date: Thu, 24 Sep 2026 18:00:13 +0000 Subject: [PATCH] Update Facility .NET repository conventions --- .agents/skills/dotnet-inspect/SKILL.md | 6 +++--- apm.lock.yaml | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/.agents/skills/dotnet-inspect/SKILL.md b/.agents/skills/dotnet-inspect/SKILL.md index 90edc5d..2f9bef7 100644 --- a/.agents/skills/dotnet-inspect/SKILL.md +++ b/.agents/skills/dotnet-inspect/SKILL.md @@ -27,14 +27,14 @@ target and let the router choose. Otherwise, enter the matching space directly. | Discover legal query values or demos | `vocabulary -D`; select values with `vocabulary -S Accessibility`, `-S "C# Style Choices" --json`, or `-S "C# Body Kinds"`; use `demo list` for product-home scenarios. | | Discover query facets and operators | `library -Q` lists query-capable sections; `type -Q "Body Shapes"` or `library -Q "Performance: Arrays" --json` describes accepted keys and operators without inspection. | | Find rendered body syntax | `library path/to.dll --where "Kind=ObjectCreationExpression"`, `type Type --library path/to.dll --where "Kind=InvocationExpression"`, or `member Type Method:1 --library path/to.dll --where "Kind=InvocationExpression"`; load `skill decompiler` for stable kinds and coordinates. | -| Compare APIs or method bodies | `diff --package Foo@old..new --breaking` (`--additive` new APIs; `--alloc-regressions` for allocation regressions). Single-Library API Diff supports complete Content with unprojected `--json` or the complete service value with `--envelope`; its Share is currently non-projectable. Use `type` or `member ... --match --envelope` when one API coordinate's complete correspondence outcome and diagnostics are the question; ordered match endpoints are also non-projectable. `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. | +| Compare APIs or method bodies | `diff --package Foo@old..new --breaking` (`--additive` new APIs; `--alloc-regressions` for allocation regressions; `--implementation` for the exact `Implementation Diff` section). Single-Library API Diff supports complete Content with unprojected `--json` or the complete service value with `--envelope`; its Share is currently non-projectable. Use `type` or `member ... --match --envelope` when one API coordinate's complete correspondence outcome and diagnostics are the question; ordered match endpoints are also non-projectable. `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 | `diff --history --package Foo@old..new --type Type --members --at all`; omit `--at` for full-population evaluation, repeat it for explicit checkpoints, use `--max-probes` for adaptive bisection, add `--sample-percent P` for a deterministic population-relative survey with an optional `--max-probes` cap, or use `--major-versions` for one representative per major. Major-version API history uses the first stable version, with the latest prerelease fallback for preview-only majors; Analysis history uses the latest admitted version per major. | | Inspect packages and ecosystems | `package Foo` inspects a known exact package ID; use `package Foo --version 1.2.3` to verify an exact version, `package Foo --versions -n 1` for the newest listed version row, or `package Foo@latest --versions` to force a fresh latest-version check. Use `-D` to discover sections, `-S "Package license files"` to list shipped license documents, and `-S "Signals,Audit: Findings"` to audit text-bearing files and SourceLink mappings. `package activity --ecosystem aspire` scans the named ecosystem's exact package set over the previous 42 days; add `--security-only`, paired exact `--from`/`--through` UTC timestamps, or complete Content `--json`; use `--envelope` for the full service value. Load `skill private-feeds` for custom/authenticated sources. | | Query packages | `package query Foo` selects the latest eligible listed version; use `'Foo.*'` for a literal package-ID prefix. The closed nuspec license values are `any`, `MIT`, and `OSMF`; use them with `--where` and `--nuspec-only` to avoid opening archives. Add `--where "library-literal=TEXT" --tfm net10.0` to AND-compose exact decoded-`ldstr` qualification with ordinary terms, then select `-S "Literal Strings"` to itemize physical matches with their Library, Method Token, IL Offset, and complete decoded Literal. The Product planner authors `library-target` from `--tfm`; metadata-expensive queries admit at most five candidates. Final Results retain typed selected-library context, exact Root reopening, and complete occurrences. `-n` and `--rows` select package Results, not occurrences. `--envelope` retains complete `package-query` Content and diagnostics, but Package Query Share is currently non-projectable. | | Inspect a Workspace | `workspace --package Foo@version --tfm net10.0`; repeat `--package` to compose ordered Package occurrences, then add inert top-level intent with `--register-library PACKAGE@VERSION/ASSEMBLY@ASSEMBLY_VERSION`, `--register-package-prefix PREFIX`, or `--register-ecosystem ID`. Filter the typed inventory with repeatable `--kind`; `-n` and `--rows` select complete inventory entries after that filter, while `--lines` explicitly selects rendered lines. Restore a current-format canonical packet with `--packet PACKET`; Workspace Definitions realizes its complete context and retained Navigation state before inventory. Exact Package duplicates coalesce; packages without compile assemblies remain members. Use `--verbose` for Package producer/target details and `--share packet` or `--share url` only on top-level inventory. Add `--active-package N` on direct construction for structural hierarchy, Library asset IDs, Type/Member inventory, lenses, and diagnostics. Use `--root-request TOKEN` instead to reopen the exact Root a `package query --where "library-literal=..."` result names; it is refused rather than approximated by package id and version. | | Edit a portable Workspace | Use `workspace component list --packet "$w"` to obtain canonical paths. Then use `workspace package add PACKAGE@VERSION --packet "$w"`, `workspace package update packages/ID@VERSION/TFM/RID --packet "$w" --version NEW`, or `workspace package remove packages/ID@VERSION/TFM/RID --packet "$w"`. Edits emit a new packet by default; add and update can select a context or TFM as supported, and update can emit `--json --envelope`. Use `workspace packet encode` or `workspace packet decode` for packet conversion. | -| Discover or inspect a library | `library Foo` or `library path/to.dll` inspects a known source; use `library query ./bin --where "references=System.Text.Json"` or `library query --platform runtime ...` for Library-grain discovery. Use `-D` to discover sections, `-D --details` to add structural format capabilities, `-S "Library Metrics"` for a whole-library structural report, and `-S "Unsafe Members"` for standalone unsafe evidence. Load `skill metadata` for raw ECMA-335 tables/heaps. | -| Dependencies and relationships | `depends --package Foo@version --tfm net10.0` for a package graph plus declaration evidence; add `-S Dependencies` for evidence only or explicitly select `-S Pruning` to compare direct package candidates with an installed platform inventory. Use `graph calls TYPE MEMBER --root-package Foo@version --root-tfm net10.0` for an external-focused member graph that automatically follows the root package dependencies. Use `depends Type`, `extensions Type`, or `implements Interface` for type relationships. Positional `depends Type` supports complete Content with `--json` or the complete service value with `--envelope`; asset mode does not support envelopes. Load `skill relationships` for scopes and semantics. | +| Discover or inspect a library | `library Foo` or `library path/to.dll` inspects a known source; use `library query ./bin --where "references=System.Text.Json"` or `library query --platform runtime ...` for Library-grain discovery. Use `-D` to discover sections, `-D --details` to add structural format capabilities, `-S "Library Metrics"` for a whole-library structural report, and `-S "Unsafe Members"` for standalone unsafe evidence. Exact Library `--count` counts public Type declarations; `type Type --library path/to.dll --count` counts Members. Load `skill metadata` for raw ECMA-335 tables/heaps. | +| Dependencies and relationships | `depends --package Foo@version --tfm net10.0` for a package graph plus declaration evidence; add `-S Dependencies` for evidence only or explicitly select `-S Pruning` to compare direct package candidates with an installed platform inventory. Use `graph calls TYPE MEMBER --root-package Foo@version --root-tfm net10.0` for an external-focused member graph that automatically follows the root package dependencies. Its default baseline highlights third-party Package boundaries; use `--baseline self` or `--baseline nothing` to change that focus. Use `graph libraries --library ./Consumer.dll --library ./Provider.dll -S "Direct Use Clusters"` for exact pairwise call-use clusters. Use `depends Type`, `extensions Type`, or `implements Interface` for type relationships. Positional `depends Type` supports complete Content with `--json` or the complete service value with `--envelope`; asset mode does not support envelopes. Load `skill relationships` for scopes and semantics. | ## Member lookup diff --git a/apm.lock.yaml b/apm.lock.yaml index 14102f5..8ef6951 100644 --- a/apm.lock.yaml +++ b/apm.lock.yaml @@ -1,5 +1,5 @@ lockfile_version: '1' -generated_at: '2026-09-23T17:59:53.386223+00:00' +generated_at: '2026-09-24T18:00:13.508324+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: c7c7ec90ea4c3c5fb866ccacbcf93cfc398a4468 + resolved_commit: a2cecf7dcbf36f1f76f9549d244afa8ac808a5a6 virtual_path: skills/dotnet-inspect is_virtual: true package_type: claude_skill deployed_files: - .agents/skills/dotnet-inspect - content_hash: sha256:e174b73a490002a74bc2450167d5b0a69c2284ffba5277bc2606c6011a4f517f + content_hash: sha256:13bb04774bb58f4c31735cc1df0ebddd8b474630f56674819da2952563edb756