docs(comments): strip internal task/milestone/bundle bookkeeping from code comments
Remove project bookkeeping citations from shipped code comments across the solution: hyphenated task IDs (WP-14, StoreAndForward-025), milestone/task/ issue refs (M3, Task 4, Audit Log #23, #21), Bundle X task-bundle labels, and C/D/K/S/T phase labels. Comment text only — no code logic, string/log literals, or XML-doc structure changed. Genuine descriptions are preserved (only the citation is stripped), and technical lookalikes are retained (UTF-8, SHA-256, T00:00:00, M365, UTC-5, pre-C4/pre-C5 schema versions). Flagged by the new CommentChecker TaskReferenceInComment / TrackingReferenceInComment checks plus targeted grep passes; full solution builds clean, append-only guard tests pass.
This commit is contained in:
@@ -27,13 +27,12 @@ internal static class CommandHelpers
|
||||
/// body instead of running the default <see cref="HandleResponse"/> rendering path —
|
||||
/// useful when the caller needs to capture the response (e.g. write a file) rather
|
||||
/// than print it. The authorization-failure exit-code contract
|
||||
/// (<see cref="IsAuthorizationFailure"/>) is preserved on the error path either way,
|
||||
/// closing CLI-017's regression.
|
||||
/// (<see cref="IsAuthorizationFailure"/>) is preserved on the error path either way.
|
||||
/// </param>
|
||||
/// <param name="tableProjector">
|
||||
/// Optional transform applied to the success JSON body <em>only</em> when the resolved
|
||||
/// format is <c>table</c>. Lets a command render a compact table projection (e.g.
|
||||
/// <c>template list</c> dropping per-template attribute dumps, followup #6) while
|
||||
/// <c>template list</c> dropping per-template attribute dumps) while
|
||||
/// leaving JSON output untouched for machine consumers. Ignored when
|
||||
/// <paramref name="onSuccess"/> is supplied.
|
||||
/// </param>
|
||||
@@ -95,8 +94,7 @@ internal static class CommandHelpers
|
||||
|
||||
// Caller-supplied success handler short-circuits the default rendering — but
|
||||
// the error path still routes through IsAuthorizationFailure so the documented
|
||||
// exit-2 contract holds whether or not a custom handler is provided
|
||||
// (CLI-017 unification of the bundle path).
|
||||
// exit-2 contract holds whether or not a custom handler is provided.
|
||||
if (onSuccess is not null)
|
||||
{
|
||||
if (response.JsonData is not null)
|
||||
@@ -255,7 +253,7 @@ internal static class CommandHelpers
|
||||
|
||||
// Derive the header set as the union of property names across *every*
|
||||
// element, in first-seen order. Using only items[0] would silently drop
|
||||
// columns for any later element with a different shape (CLI-016).
|
||||
// columns for any later element with a different shape.
|
||||
var objectItems = items.Where(i => i.ValueKind == JsonValueKind.Object).ToList();
|
||||
string[] headers;
|
||||
if (objectItems.Count > 0)
|
||||
|
||||
Reference in New Issue
Block a user