@warpgogol/forge 2.9.4 → 2.9.5

package/dist/src/validators/note-link-validate.js

@@ -114,7 +114,7 @@ export function runNoteLinkValidate(input, context) {
         },
         exitCode: violations.length > 0 ? 1 : 0,
         summary: violations.length > 0
-            ? `note.link.validate: ${violations.length} violation(s) found`
+            ? `note.link.validate: ${violations.length} violation${violations.length === 1 ? "" : "s"} found`
             : "note.link.validate: OK — 0 violations",
     };
 }

package/dist/src/validators/note-link-validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"note-link-validate.js","sourceRoot":"","sources":["../../../src/validators/note-link-validate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"note-link-validate.js","sourceRoot":"","sources":["../../../src/validators/note-link-validate.ts"],"names":[],"mappings":"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"}

package/os/adr/adr-0000-template.md

@@ -0,0 +1,46 @@
+---
+id: ADR-0000
+title: "Short imperative title"
+# Lifecycle:
+#   proposed → reviewing → accepted → implemented
+#   any → superseded (requires supersededBy)
+#   any → rejected
+status: proposed
+scope: package
+decider: architecture
+createdAt: YYYY-MM-DD
+updatedAt: YYYY-MM-DD
+implementedAt:
+closedAt:
+supersedes: []
+supersededBy:
+related: []
+# Set by the deciding human together with the status change.
+# Draft scaffolds must keep this empty; do not prefill a default identity.
+# Format: human:<handle>
+reviewers: []
+---
+
+# ADR-0000: Short imperative title
+
+## Context
+
+Brief description of the local situation, constraints, and RFC or DNA context that bounds the decision. Name actual packages, files, or components.
+
+## Decision
+
+A single sentence in the present tense stating the decision as a fact. Add 1-3 bullets clarifying scope or boundaries if needed.
+
+## Justification
+
+Forces and trade-offs that led to the decision: alternatives considered, constraints, alignment with existing architecture.
+
+## Consequences
+
+- Positive: what becomes simpler, safer, cheaper, or more predictable.
+- Negative: trade-offs, limitations, operational overhead.
+- Technical debt: what is knowingly postponed.
+
+## Evolution
+
+How the decision may change: thresholds that trigger revisiting it, metrics to watch, and — for post-hoc ADRs — references to commits or PRs that implemented it.

package/os/adr/handlers/implement-stamp.ts

@@ -332,6 +332,6 @@ function stampFailResult(
       violations,
     },
     exitCode: 1,
-    summary: `${prefix}adr.implement.stamp: ${violations.length} violation(s)`,
+    summary: `${prefix}adr.implement.stamp: ${violations.length} violation${violations.length === 1 ? "" : "s"}`,
   };
 }

package/os/adr/handlers/list-create.ts

@@ -12,8 +12,11 @@
 */
 
 import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { toKebabCase } from "../../../src/utils/string-utils.ts";
+import { resolveForgeRoot } from "../../../src/config/forge-config.ts";
 import { listAdrFiles, readAndParseAdr } from "../frontmatter-io.ts";
 import type {
   ForgeCommandInput,
@@ -27,7 +30,13 @@ import type {
   AdrStatus,
   AdrScope,
 } from "../types.ts";
-import { ADR_DIR, ADR_TEMPLATE_FILE, ADR_SCOPES, ADR_STATUSES } from "../types.ts";
+import {
+  ADR_DIR,
+  ADR_TEMPLATE_FILE,
+  ADR_TEMPLATE_FALLBACK_FILE,
+  ADR_SCOPES,
+  ADR_STATUSES,
+} from "../types.ts";
 
 function toIsoDate(d: Date): string {
   return d.toISOString().slice(0, 10);
@@ -137,14 +146,13 @@ export async function runAdrCreate(
   const nextSlug = `adr-${paddedNum}`;
   const nextId = `ADR-${paddedNum}`;
 
-  const templateRelPath = ADR_TEMPLATE_FILE;
-  const templatePath = path.join(workspaceRoot, templateRelPath);
+  const templatePath = resolveAdrTemplate(workspaceRoot);
   let templateContent: string;
   try {
     templateContent = await fs.readFile(templatePath, "utf-8");
   } catch {
     throw new Error(
-      `ADR template not found at ${templateRelPath}. Ensure docs/adrs/ contains the template.`,
+      `ADR template not found at ${templatePath}. Ensure docs/adrs/ contains the template.`,
     );
   }
 
@@ -205,3 +213,39 @@ export async function runAdrCreate(
     summary: `Created ${nextId}: ${title}`,
   };
 }
+
+// ---------------------------------------------------------------------------
+// ADR template resolver — finds adr-0000-template.md from project docs/adrs/
+// first (canonical location), then falls back to the forge package copy
+// (npm consumers without a project-level template).
+// ---------------------------------------------------------------------------
+
+function resolveAdrTemplate(workspaceRoot: string): string {
+  // 1. Try project-level docs/adrs/adr-0000-template.md (canonical)
+  const projectPath = path.join(workspaceRoot, ADR_TEMPLATE_FILE);
+  if (existsSync(projectPath)) return projectPath;
+
+  // 2. Try forge root (monorepo or npm-installed) — fallback copy
+  try {
+    const forgeRoot = resolveForgeRoot(workspaceRoot);
+    const p = path.join(forgeRoot, ADR_TEMPLATE_FALLBACK_FILE);
+    if (existsSync(p)) return p;
+  } catch {
+    // forge root not resolvable — fall through to module-relative search
+  }
+
+  // 3. Fallback: walk up from this module's location to find os/adr/adr-0000-template.md
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  let dir = here;
+  for (let i = 0; i < 10; i++) {
+    const candidate = path.join(dir, "os", "adr", "adr-0000-template.md");
+    if (existsSync(candidate)) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  throw new Error(
+    `ADR template not found. Tried ${ADR_TEMPLATE_FILE} relative to ${workspaceRoot}, forge root, and module-relative search from ${here}.`,
+  );
+}

package/os/adr/handlers/validate.ts

@@ -135,10 +135,14 @@ export async function runAdrValidate(
       }
       const errorCount = violations.filter((v) => v.severity === "error").length;
       const warnCount = violations.filter((v) => v.severity === "warning").length;
+      const parts: string[] = [];
+      if (errorCount > 0) parts.push(`${errorCount} error${errorCount === 1 ? "" : "s"}`);
+      if (warnCount > 0) parts.push(`${warnCount} warning${warnCount === 1 ? "" : "s"}`);
+      const counts = parts.join(", ");
       if (errorCount > 0) {
-        logger.error(`${errorCount} error(s), ${warnCount} warning(s)`);
+        logger.error(counts);
       } else {
-        logger.warn(`${warnCount} warning(s), 0 errors — passed`);
+        logger.warn(`${counts} — passed`);
       }
     }
   }
@@ -152,12 +156,12 @@ export async function runAdrValidate(
     },
     exitCode: hasErrors ? 1 : 0,
     summary: hasErrors
-      ? `${violations.filter((v) => v.severity === "error").length} error(s) found`
+      ? `${violations.filter((v) => v.severity === "error").length} error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} found`
       : `All ${filesToValidate.length} ADR(s) passed validation`,
     nextSteps: hasErrors
       ? [
           {
-            action: `Fix the ${violations.filter((v) => v.severity === "error").length} error(s) above, then re-run: pnpm exec forge run adr.validate`,
+            action: `Fix the ${violations.filter((v) => v.severity === "error").length} error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} above, then re-run: pnpm exec forge run adr.validate`,
             kind: "required",
           },
         ]

package/os/adr/types.ts

@@ -92,6 +92,7 @@ export interface AdrCreateResult {
 
 export const ADR_DIR = "docs/adrs";
 export const ADR_TEMPLATE_FILE = "docs/adrs/adr-0000-template.md";
+export const ADR_TEMPLATE_FALLBACK_FILE = "os/adr/adr-0000-template.md";
 export const ADR_ID_PATTERN = /^ADR-\d{4}$/;
 
 export const ADR_REQUIRED_SECTIONS = [

package/os/core/handlers/package-health.ts

@@ -199,12 +199,16 @@ export async function runPackageHealth(
           `forge.package.health: all ${packagesChecked} published package(s) healthy.`,
         );
       } else if (passed) {
-        logger.success(
-          `forge.package.health: ${packagesChecked} package(s) checked, ${warnings.length} warning(s).`,
+        logger.warn(
+          `forge.package.health: ${packagesChecked} package(s) checked, ${warnings.length} warning${warnings.length === 1 ? "" : "s"}.`,
         );
       } else {
+        const parts: string[] = [];
+        parts.push(`${errors.length} error${errors.length === 1 ? "" : "s"}`);
+        if (warnings.length > 0)
+          parts.push(`${warnings.length} warning${warnings.length === 1 ? "" : "s"}`);
         logger.error(
-          `forge.package.health: ${errors.length} error(s), ${warnings.length} warning(s) across ${packagesChecked} package(s).`,
+          `forge.package.health: ${parts.join(", ")} across ${packagesChecked} package(s).`,
         );
       }
     }
@@ -220,9 +224,9 @@ export async function runPackageHealth(
     exitCode: passed ? 0 : 1,
     summary: passed
       ? warnings.length > 0
-        ? `All ${packagesChecked} package(s) passed with ${warnings.length} warning(s).`
+        ? `All ${packagesChecked} package(s) passed with ${warnings.length} warning${warnings.length === 1 ? "" : "s"}.`
         : `All ${packagesChecked} package(s) healthy.`
-      : `${errors.length} error(s) found across ${packagesChecked} package(s).`,
+      : `${errors.length} error${errors.length === 1 ? "" : "s"} found across ${packagesChecked} package(s).`,
     nextSteps: errors.map((e) => ({
       action: e.fixHint ?? e.message,
       kind: "required" as const,

package/os/core/handlers/pinned-validate.ts

@@ -283,7 +283,9 @@ export async function runPinnedValidate(
         logger.success("pinned.validate: no violations");
       }
     } else {
-      logger.error(`pinned.validate: ${remainingViolations.length} violation(s) found`);
+      logger.error(
+        `pinned.validate: ${remainingViolations.length} violation${remainingViolations.length === 1 ? "" : "s"} found`,
+      );
       for (const v of remainingViolations) {
         logger.error(`  ${v.operation}: ${v.path} (mode: ${v.mode}) — ${v.reason}`);
       }
@@ -296,6 +298,6 @@ export async function runPinnedValidate(
     summary:
       status === "pass"
         ? `No violations${appliedOverrides.length > 0 ? ` (${appliedOverrides.length} override(s) applied)` : ""}`
-        : `${remainingViolations.length} violation(s) found`,
+        : `${remainingViolations.length} violation${remainingViolations.length === 1 ? "" : "s"} found`,
   };
 }

package/os/program/handlers/complete.ts

@@ -426,10 +426,10 @@ function completeFail(
       violations,
     },
     exitCode: 1,
-    summary: `program.packet.complete: ${packetId} failed with ${violations.length} violation(s)`,
+    summary: `program.packet.complete: ${packetId} failed with ${violations.length} violation${violations.length === 1 ? "" : "s"}`,
     nextSteps: [
       {
-        action: `Fix the ${violations.length} violation(s) above, then re-run: pnpm exec forge run program.packet.complete --packet ${packetId}`,
+        action: `Fix the ${violations.length} violation${violations.length === 1 ? "" : "s"} above, then re-run: pnpm exec forge run program.packet.complete --packet ${packetId}`,
         kind: "required",
       },
     ],

package/os/program/handlers/lease.ts

@@ -434,6 +434,6 @@ function leaseFail(
       violations,
     },
     exitCode: 1,
-    summary: `program.packet.lease: ${packetId} ${action} failed with ${violations.length} violation(s)`,
+    summary: `program.packet.lease: ${packetId} ${action} failed with ${violations.length} violation${violations.length === 1 ? "" : "s"}`,
   };
 }

package/os/program/handlers/seal.ts

@@ -248,10 +248,10 @@ function sealFail(
       violations,
     },
     exitCode: 1,
-    summary: `program.packet.seal: ${packetId} failed with ${violations.length} violation(s)`,
+    summary: `program.packet.seal: ${packetId} failed with ${violations.length} violation${violations.length === 1 ? "" : "s"}`,
     nextSteps: [
       {
-        action: `Fix the ${violations.length} violation(s) above, then re-run: pnpm exec forge run program.packet.seal --packet ${packetId}`,
+        action: `Fix the ${violations.length} violation${violations.length === 1 ? "" : "s"} above, then re-run: pnpm exec forge run program.packet.seal --packet ${packetId}`,
         kind: "required",
       },
     ],

package/os/program/handlers/validate.ts

@@ -186,7 +186,7 @@ export async function runValidate(
     summary:
       status === "pass"
         ? `program.packet.validate: ${packetId} passed (${phase})`
-        : `program.packet.validate: ${packetId} failed with ${violations.length} violation(s)`,
+        : `program.packet.validate: ${packetId} failed with ${violations.length} violation${violations.length === 1 ? "" : "s"}`,
   };
 }
 
@@ -208,10 +208,10 @@ function failResult(
       violations,
     },
     exitCode: 1,
-    summary: `program.packet.validate: ${packetId} failed with ${violations.length} violation(s)`,
+    summary: `program.packet.validate: ${packetId} failed with ${violations.length} violation${violations.length === 1 ? "" : "s"}`,
     nextSteps: [
       {
-        action: `Fix the ${violations.length} violation(s) above, then re-run: pnpm exec forge run program.packet.validate --packet ${packetId}`,
+        action: `Fix the ${violations.length} violation${violations.length === 1 ? "" : "s"} above, then re-run: pnpm exec forge run program.packet.validate --packet ${packetId}`,
         kind: "required",
       },
     ],

package/os/rfc/dna-trace.ts

@@ -233,7 +233,7 @@ export async function runRfcDnaTraceValidate(
       diagnostics,
     },
     exitCode: hasErrors ? 1 : 0,
-    summary: `rfc.dna.trace.validate: ${registryIds.size} DNA invariants, ${tracedDnaCount} traced, ${diagnostics.filter((d) => d.severity === "error").length} error(s)`,
+    summary: `rfc.dna.trace.validate: ${registryIds.size} DNA invariants, ${tracedDnaCount} traced, ${diagnostics.filter((d) => d.severity === "error").length} error${diagnostics.filter((d) => d.severity === "error").length === 1 ? "" : "s"}`,
   };
 }
 

package/os/rfc/handlers/check.ts

@@ -219,7 +219,7 @@ export async function runRfcCheck(
       for (const v of violations) {
         logger.error(`[${v.kind}] ${v.rfcId}: ${v.message}`);
       }
-      logger.error(`${violations.length} violation(s) found`);
+      logger.error(`${violations.length} violation${violations.length === 1 ? "" : "s"} found`);
     }
   }
 
@@ -232,12 +232,12 @@ export async function runRfcCheck(
     },
     exitCode: hasErrors ? 1 : 0,
     summary: hasErrors
-      ? `${violations.length} artifact violation(s) found across ${checkedRfcs} RFC(s)`
+      ? `${violations.length} artifact violation${violations.length === 1 ? "" : "s"} found across ${checkedRfcs} RFC(s)`
       : `All ${checkedRfcs} RFC(s) passed artifact check`,
     nextSteps: hasErrors
       ? [
           {
-            action: `Fix the ${violations.length} artifact violation(s) above, then re-run: pnpm exec forge run rfc.check`,
+            action: `Fix the ${violations.length} artifact violation${violations.length === 1 ? "" : "s"} above, then re-run: pnpm exec forge run rfc.check`,
             kind: "required",
           },
         ]

package/os/rfc/handlers/implement-stamp.ts

@@ -516,6 +516,6 @@ function stampFailResult(
       violations,
     },
     exitCode: 1,
-    summary: `${prefix}rfc.implement.stamp: ${violations.length} violation(s)`,
+    summary: `${prefix}rfc.implement.stamp: ${violations.length} violation${violations.length === 1 ? "" : "s"}`,
   };
 }

package/os/rfc/handlers/index-graph.ts

@@ -175,7 +175,7 @@ export async function runRfcIndexValidate(
     return {
       data: result,
       exitCode: 1,
-      summary: "1 error(s) found",
+      summary: "1 error found",
     };
   }
 
@@ -196,7 +196,7 @@ export async function runRfcIndexValidate(
     return {
       data: result,
       exitCode: 1,
-      summary: "1 error(s) found",
+      summary: "1 error found",
     };
   }
 
@@ -221,7 +221,7 @@ export async function runRfcIndexValidate(
       for (const v of violations) {
         logger.error(`[${v.rule}] ${v.message}`);
       }
-      logger.error(`${violations.length} error(s) found`);
+      logger.error(`${violations.length} error${violations.length === 1 ? "" : "s"} found`);
     } else {
       logger.success(`Index valid — ${indexCount} entries match ${fileCount} RFC files.`);
     }
@@ -231,7 +231,7 @@ export async function runRfcIndexValidate(
     data: result,
     exitCode: hasErrors ? 1 : 0,
     summary: hasErrors
-      ? `${violations.length} error(s) found`
+      ? `${violations.length} error${violations.length === 1 ? "" : "s"} found`
       : `Index valid — ${indexCount} entries match ${fileCount} RFC files`,
   };
 }

package/os/rfc/handlers/lifecycle.ts

@@ -243,7 +243,7 @@ export async function runRfcCommandLifecycleValidate(
     },
     exitCode: hasErrors ? 1 : 0,
     summary: hasErrors
-      ? `${violations.filter((v) => v.severity === "error").length} command lifecycle error(s) found`
+      ? `${violations.filter((v) => v.severity === "error").length} command lifecycle error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} found`
       : `All ${checkedCount} RFC(s) passed command lifecycle validation`,
   };
 }

package/os/rfc/handlers/validate.ts

@@ -142,10 +142,14 @@ export async function runRfcValidate(
       }
       const errorCount = violations.filter((v) => v.severity === "error").length;
       const warnCount = violations.filter((v) => v.severity === "warning").length;
+      const parts: string[] = [];
+      if (errorCount > 0) parts.push(`${errorCount} error${errorCount === 1 ? "" : "s"}`);
+      if (warnCount > 0) parts.push(`${warnCount} warning${warnCount === 1 ? "" : "s"}`);
+      const counts = parts.join(", ");
       if (errorCount > 0) {
-        logger.error(`${errorCount} error(s), ${warnCount} warning(s)`);
+        logger.error(counts);
       } else {
-        logger.warn(`${warnCount} warning(s), 0 errors — passed`);
+        logger.warn(`${counts} — passed`);
       }
     }
   }
@@ -160,12 +164,12 @@ export async function runRfcValidate(
     },
     exitCode: hasErrors ? 1 : 0,
     summary: hasErrors
-      ? `${violations.filter((v) => v.severity === "error").length} error(s) found`
+      ? `${violations.filter((v) => v.severity === "error").length} error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} found`
       : `All ${filesToValidate.length} RFC(s) passed validation`,
     nextSteps: hasErrors
       ? [
           {
-            action: `Fix the ${violations.filter((v) => v.severity === "error").length} error(s) above, then re-run: pnpm exec forge run rfc.validate`,
+            action: `Fix the ${violations.filter((v) => v.severity === "error").length} error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} above, then re-run: pnpm exec forge run rfc.validate`,
             kind: "required",
           },
         ]

package/os/rfc/rfc-0000-template.md

@@ -8,10 +8,9 @@ kind: architecture
 scope: workspace
 owners:
   - architecture
-# Set by the deciding human together with the status change (RFC-0335).
+# Set by the deciding human together with the status change.
 # Draft scaffolds must keep this empty; do not prefill a default identity.
-# Format: human:<handle> (agent:<id> reserved — see RFC-0335).
-# Default reviewer when none is specified by the operator: human:andrii-syrokomskyi
+# Format: human:<handle>
 reviewers: []
 createdAt: YYYY-MM-DD
 updatedAt: YYYY-MM-DD
@@ -26,8 +25,6 @@ related:
   # - DNA-1
   # - AP-3
   # - RFC-0005
-  # - PAGE-MANDATORY-ARTIFACTS
-  # - COMPONENT-THREE-WAY-MIRROR
 # RFC-0331: DNA invariants this RFC implements, protects, or extends.
 # Required for architecture/contract RFCs created on or after 2026-07-07.
 # Entries must match ^DNA-\d+$ and exist in docs/architecture-dna.md.
@@ -55,17 +52,16 @@ appsImpacted: []
 packagesImpacted: []
 successSignals: []
 nonGoals: []
-# RFC-0268: OPTIONAL machine-checkable acceptance probes, executed on-demand
-# via `pnpm exec werkstatt run rfc.acceptance.run --id <this-rfc-id>` (never
-# automatically inside build pipelines). Closed probe vocabulary — see
-# docs/rfcs/rfc-0268-make-rfc-acceptance-criteria-machine-checkable.md.
+# OPTIONAL machine-checkable acceptance probes, executed on-demand
+# via `pnpm exec forge rfc.acceptance.run --id <this-rfc-id>` (never
+# automatically inside build pipelines).
 # acceptance:
 #   - probe: run
-#     command: "site-kernel run some.command.validate --app warpgogol-com"
+#     command: "pnpm exec forge some.command.validate"
 #     expect:
 #       exitCode: 0
 #   - probe: file-exists
-#     path: "packages/share/src/some-new-module.ts"
+#     path: "packages/my-package/src/some-new-module.ts"
 #   - probe: command-registered
 #     name: "some.new.command"
 #   - probe: file-contains
@@ -119,8 +115,8 @@ nonGoals: []
 <!-- Show the exact command(s) as a user would type them:
 
 ```sh
-pnpm exec werkstatt run domain.command --app main
-pnpm exec werkstatt run domain.command --all --json
+pnpm exec forge domain.command
+pnpm exec forge domain.command --json
 ```
 
 Describe flags, arguments, and scope (app | workspace).
@@ -150,7 +146,7 @@ interface ExampleResult {
 
 | Path | Role |
 |---|---|
-| `src/pages/[lang]/**/*.astro` | Scanned for violations |
+| `src/**/*.ts` | Scanned for violations |
 | `docs/rfcs/index.json` | Updated by rfc.index.generate |
 -->
 
@@ -163,7 +159,7 @@ interface ExampleResult {
   "command": "domain.command",
   "status": "fail",
   "violations": [
-    { "file": "src/pages/de/legal.astro", "rule": "missing-schema", "message": "..." }
+    { "file": "src/some-file.ts", "rule": "missing-schema", "message": "..." }
   ]
 }
 ```
@@ -216,12 +212,12 @@ interface ExampleResult {
 
 - Agents MAY implement code changes ONLY when this RFC has status: accepted (or implemented).
 - Agents MAY transition this RFC from `accepted` to `implemented` per RFC-0224 preconditions; reference this RFC ID in commits.
-- For RFCs created on or after 2026-07-07 with acceptance probes: before stamping `implemented`, run
-  `site-kernel run rfc.verification.emit --id <this-rfc-id>` and commit the evidence file
-  in the same commit (RFC-0330 amended transition precondition).
+- For RFCs with acceptance probes: before stamping `implemented`, run
+  `pnpm exec forge rfc.verification.emit --id <this-rfc-id>` and commit the evidence file
+  in the same commit.
 - Agents MUST NOT weaken or remove enforcement rules established by this RFC
   without a new RFC that supersedes it.
 - If implementation reveals an invariant conflict, run
-  `site-kernel run rfc.supersede.propose --id <this-rfc-id> --reason "..." --invariant "DNA-N"`
-  instead of working around it (RFC-0334).
+  `pnpm exec forge rfc.supersede.propose --id <this-rfc-id> --reason "..." --invariant "DNA-N"`
+  instead of working around it.
 -->

package/os/session/handlers/validate.ts

@@ -227,10 +227,14 @@ export async function runSessionValidate(
       }
       const errorCount = violations.filter((v) => v.severity === "error").length;
       const warnCount = violations.filter((v) => v.severity === "warning").length;
+      const parts: string[] = [];
+      if (errorCount > 0) parts.push(`${errorCount} error${errorCount === 1 ? "" : "s"}`);
+      if (warnCount > 0) parts.push(`${warnCount} warning${warnCount === 1 ? "" : "s"}`);
+      const counts = parts.join(", ");
       if (errorCount > 0) {
-        logger.error(`${errorCount} error(s), ${warnCount} warning(s)`);
+        logger.error(counts);
       } else {
-        logger.warn(`${warnCount} warning(s), 0 errors — passed`);
+        logger.warn(`${counts} — passed`);
       }
     }
   }
@@ -244,12 +248,12 @@ export async function runSessionValidate(
     },
     exitCode: hasErrors ? 1 : 0,
     summary: hasErrors
-      ? `${violations.filter((v) => v.severity === "error").length} error(s) found`
+      ? `${violations.filter((v) => v.severity === "error").length} error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} found`
       : `All ${filesToValidate.length} session file(s) passed validation`,
     nextSteps: hasErrors
       ? [
           {
-            action: `Fix the ${violations.filter((v) => v.severity === "error").length} error(s) above, then re-run: pnpm exec forge run session.validate`,
+            action: `Fix the ${violations.filter((v) => v.severity === "error").length} error${violations.filter((v) => v.severity === "error").length === 1 ? "" : "s"} above, then re-run: pnpm exec forge run session.validate`,
             kind: "required",
           },
         ]

package/os/spec/live-spec-validate.ts

@@ -151,7 +151,7 @@ export async function runSpecLiveValidate(
 
   if (outputFormat === "pretty") {
     if (hasFailures) {
-      logger.error(`spec.live.validate: ${violations.length} violation(s) across ${specsChecked} spec(s)`);
+      logger.error(`spec.live.validate: ${violations.length} violation${violations.length === 1 ? "" : "s"} across ${specsChecked} spec(s)`);
       for (const v of violations) {
         logger.error(`  ${v.rule}: ${v.message}`);
       }
@@ -164,7 +164,7 @@ export async function runSpecLiveValidate(
     data: result,
     exitCode: hasFailures ? 1 : 0,
     summary: hasFailures
-      ? `spec.live.validate: ${violations.length} violation(s)`
+      ? `spec.live.validate: ${violations.length} violation${violations.length === 1 ? "" : "s"}`
       : `spec.live.validate: ${specsChecked} spec(s) — pass`,
   };
 }

package/os/spec/spec-validate.ts

@@ -490,7 +490,7 @@ export async function runSpecValidate(
         if (result.violations.length === 0) {
           logger.success(`spec.validate: ${result.id} — pass`);
         } else {
-          logger.error(`spec.validate: ${result.id} — ${result.violations.length} violation(s)`);
+          logger.error(`spec.validate: ${result.id} — ${result.violations.length} violation${result.violations.length === 1 ? "" : "s"}`);
           for (const v of result.violations) {
             logger.error(`  ${v.rule}: ${v.message}`);
           }

package/os/workflow/handlers.ts

@@ -307,7 +307,7 @@ export async function runWorkflowLint(
     exitCode: violations.length > 0 ? 1 : 0,
     summary:
       violations.length > 0
-        ? `workflow.lint: ${violations.length} violation(s)`
+        ? `workflow.lint: ${violations.length} violation${violations.length === 1 ? "" : "s"}`
         : `workflow.lint: ${workflows.length} workflow file(s) valid`,
   };
 }