@warpgogol/forge 0.10.0 → 0.12.0

package/dist/os/core/handlers/release-publish.js

@@ -0,0 +1,173 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.release.publish — publish a prepared release to the declared target (local, R2, S3). Supports --dry-run, --json, --profile.</purpose>
+<non-goals>
+  <item>Do not implement release preparation — that lives in release-prepare.ts.</item>
+  <item>Do not import from @warpgogol/* in autonomous modules — os/core/ may import from @warpgogol/*.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0680: initial forge.release.publish handler with local/r2/s3 targets, --dry-run, env var validation.</item>
+  <item>RFC-0680 review fix: remove unused readdir import (A-1).</item>
+  <item>RFC-0680 review fix: add S3_ENDPOINT to required env vars (G-1).</item>
+  <item>RFC-0680 review fix: add 30s request timeout on S3Client (G-2).</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile, copyFile, mkdir } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { resolveActiveProfile, resolveLifecycleFlags } from "./profile-resolve.js";
+function getRequiredEnvVars(target) {
+    if (target === "r2") {
+        return ["R2_ACCOUNT_ID", "R2_ACCESS_KEY_ID", "R2_SECRET_ACCESS_KEY"];
+    }
+    if (target === "s3") {
+        return ["S3_BUCKET", "S3_ACCESS_KEY_ID", "S3_SECRET_ACCESS_KEY", "S3_ENDPOINT"];
+    }
+    return [];
+}
+export async function runReleasePublish(input, context) {
+    const { workspaceRoot, logger } = context;
+    const { dryRun, profileIdOverride } = resolveLifecycleFlags(input, context);
+    const resolved = resolveActiveProfile(workspaceRoot, context.forgeRoot, profileIdOverride);
+    if (!resolved) {
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: "",
+                target: "",
+                publishedFiles: [],
+                manifestPath: "",
+            },
+            exitCode: 1,
+            summary: "No active profile found. Set `profile` in forge.yaml or use --profile <id>.",
+            nextSteps: [{ action: "Set profile in forge.yaml or use --profile <id>", kind: "required" }],
+        };
+    }
+    const { profile } = resolved;
+    if (!profile.release) {
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: profile.id,
+                target: "",
+                publishedFiles: [],
+                manifestPath: "",
+            },
+            exitCode: 1,
+            summary: `Profile ${profile.id} does not declare a release configuration.`,
+        };
+    }
+    const releaseConfig = profile.release;
+    const releaseDir = join(workspaceRoot, releaseConfig.outputDir);
+    const manifestPath = join(releaseDir, releaseConfig.manifestName);
+    let manifest;
+    try {
+        const raw = await readFile(manifestPath, "utf8");
+        manifest = JSON.parse(raw);
+    }
+    catch {
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: profile.id,
+                target: releaseConfig.target,
+                publishedFiles: [],
+                manifestPath,
+            },
+            exitCode: 1,
+            summary: `No release manifest found at ${manifestPath}. Run \`forge release prepare\` first.`,
+        };
+    }
+    const target = releaseConfig.target;
+    const requiredVars = getRequiredEnvVars(target);
+    const missingVars = requiredVars.filter((v) => !process.env[v]);
+    if (missingVars.length > 0) {
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: profile.id,
+                target,
+                publishedFiles: [],
+                manifestPath,
+            },
+            exitCode: 1,
+            summary: `Missing required environment variables: ${missingVars.join(", ")}`,
+        };
+    }
+    const filesToPublish = [];
+    for (const a of manifest.artifacts) {
+        filesToPublish.push(join(releaseDir, basename(a.path)));
+    }
+    filesToPublish.push(manifestPath);
+    if (dryRun) {
+        logger.info(`[dry-run] forge.release.publish — profile: ${profile.id}`);
+        logger.info(`  target: ${target}`);
+        for (const f of filesToPublish) {
+            logger.info(`  file: ${f}`);
+        }
+        return {
+            data: {
+                command: "forge.release.publish",
+                profileId: profile.id,
+                target,
+                publishedFiles: filesToPublish.map((f) => ({
+                    path: f,
+                    targetPath: target === "local"
+                        ? join(releaseDir, "published", basename(f))
+                        : `${target}://${basename(f)}`,
+                })),
+                manifestPath,
+            },
+            summary: `[dry-run] Would publish ${filesToPublish.length} file(s) to ${target}`,
+        };
+    }
+    const publishedFiles = [];
+    if (target === "local") {
+        const publishedDir = join(releaseDir, "published");
+        await mkdir(publishedDir, { recursive: true });
+        for (const f of filesToPublish) {
+            const dst = join(publishedDir, basename(f));
+            await copyFile(f, dst);
+            publishedFiles.push({ path: f, targetPath: dst });
+        }
+    }
+    else if (target === "r2" || target === "s3") {
+        const { S3Client, PutObjectCommand } = await import("@aws-sdk/client-s3");
+        const { readFile: fsReadFile } = await import("node:fs/promises");
+        const endpoint = target === "r2"
+            ? `https://${process.env.R2_ACCOUNT_ID}.r2.cloudflarestorage.com`
+            : process.env.S3_ENDPOINT;
+        const bucket = target === "r2" ? releaseConfig.r2?.bucket : process.env.S3_BUCKET;
+        const accessKeyId = target === "r2" ? process.env.R2_ACCESS_KEY_ID : process.env.S3_ACCESS_KEY_ID;
+        const secretAccessKey = target === "r2" ? process.env.R2_SECRET_ACCESS_KEY : process.env.S3_SECRET_ACCESS_KEY;
+        const prefix = target === "r2" ? (releaseConfig.r2?.prefix ?? "") : "";
+        const client = new S3Client({
+            endpoint,
+            region: "auto",
+            credentials: { accessKeyId: accessKeyId, secretAccessKey: secretAccessKey },
+            requestHandler: { requestTimeout: 30_000 },
+        });
+        for (const f of filesToPublish) {
+            const key = prefix ? `${prefix}/${basename(f)}` : basename(f);
+            const body = await fsReadFile(f);
+            await client.send(new PutObjectCommand({
+                Bucket: bucket,
+                Key: key,
+                Body: body,
+            }));
+            publishedFiles.push({ path: f, targetPath: `${target}://${bucket}/${key}` });
+        }
+    }
+    logger.success(`  Published ${publishedFiles.length} file(s) to ${target}`);
+    return {
+        data: {
+            command: "forge.release.publish",
+            profileId: profile.id,
+            target,
+            publishedFiles,
+            manifestPath,
+        },
+        summary: `Published ${publishedFiles.length} file(s) to ${target}`,
+    };
+}
+//# sourceMappingURL=release-publish.js.map

package/dist/os/core/handlers/release-publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-publish.js","sourceRoot":"","sources":["../../../../os/core/handlers/release-publish.ts"],"names":[],"mappings":"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"}

package/dist/os/core/handlers/validate.d.ts

@@ -1,8 +1,17 @@
 import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export interface ValidateViolation {
+    file: string;
+    line?: number;
+    column?: number;
+    severity: "error" | "warning";
+    message: string;
+}
 export interface ForgeValidateArtifactResult {
     id: string;
     command: string;
     exitCode: number;
+    passed: boolean;
+    violations: ValidateViolation[];
     stdout: string;
     stderr: string;
 }
@@ -10,6 +19,8 @@ export interface ForgeValidateResult {
     command: "forge.validate";
     profileId: string;
     artifacts: ForgeValidateArtifactResult[];
+    allPassed: boolean;
 }
+export declare function parseViolations(output: string, outputFormat: "plain" | "json" | undefined, violationPattern: string | undefined): ValidateViolation[];
 export declare function runValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<ForgeValidateResult>>;
 //# sourceMappingURL=validate.d.ts.map

package/dist/os/core/handlers/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/validate.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,2BAA2B,EAAE,CAAC;CAC1C;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CA6GlD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/validate.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,EAC1C,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,iBAAiB,EAAE,CAgDrB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CA0JlD"}

package/dist/os/core/handlers/validate.js

@@ -1,6 +1,6 @@
 /*
 <MODULE_CONTRACT>
-<purpose>forge.validate — execute validate commands for all artifacts declared in the active stack profile. Supports --dry-run and --json.</purpose>
+<purpose>forge.validate — execute validate commands for all artifacts declared in the active stack profile. Supports --dry-run, --json, --artifact filtering, and violation parsing.</purpose>
 <non-goals>
   <item>Do not implement dev or build logic — those are separate handlers.</item>
   <item>Do not import from @warpgogol/* — this module is portable.</item>
@@ -8,15 +8,67 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0674: initial forge.validate handler with profile resolution, --dry-run, and per-artifact execution.</item>
+  <item>RFC-0677: extended with --artifact filtering, violation parsing (outputFormat: json/plain), passed/allPassed fields.</item>
 </CHANGE_SUMMARY>
 */
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
 import { resolveActiveProfile, resolveLifecycleFlags } from "./profile-resolve.js";
 const execAsync = promisify(exec);
+export function parseViolations(output, outputFormat, violationPattern) {
+    if (outputFormat === "json") {
+        try {
+            const parsed = JSON.parse(output);
+            if (Array.isArray(parsed)) {
+                return parsed
+                    .filter((v) => typeof v === "object" && v !== null)
+                    .map((v) => ({
+                    file: String(v["file"] ?? ""),
+                    line: typeof v["line"] === "number" ? v["line"] : undefined,
+                    column: typeof v["column"] === "number" ? v["column"] : undefined,
+                    severity: (v["severity"] === "warning" ? "warning" : "error"),
+                    message: String(v["message"] ?? ""),
+                }))
+                    .filter((v) => v.file || v.message);
+            }
+            return [];
+        }
+        catch {
+            return [];
+        }
+    }
+    if (outputFormat === "plain" && violationPattern) {
+        try {
+            const regex = new RegExp(violationPattern, "gm");
+            const violations = [];
+            let match;
+            const MAX_MATCHES = 1000;
+            let matchCount = 0;
+            while ((match = regex.exec(output)) !== null && matchCount < MAX_MATCHES) {
+                matchCount++;
+                const groups = match.groups ?? {};
+                violations.push({
+                    file: String(groups["file"] ?? ""),
+                    line: groups["line"] ? Number(groups["line"]) : undefined,
+                    column: groups["column"] ? Number(groups["column"]) : undefined,
+                    severity: (groups["severity"] === "warning" ? "warning" : "error"),
+                    message: String(groups["message"] ?? match[0]),
+                });
+                if (regex.lastIndex === match.index)
+                    regex.lastIndex++;
+            }
+            return violations;
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
 export async function runValidate(input, context) {
     const { workspaceRoot, logger } = context;
     const { dryRun, profileIdOverride } = resolveLifecycleFlags(input, context);
+    const artifactFilter = typeof input.flags["artifact"] === "string" ? input.flags["artifact"] : undefined;
     const resolved = resolveActiveProfile(workspaceRoot, context.forgeRoot, profileIdOverride);
     if (!resolved) {
         return {
@@ -24,6 +76,7 @@ export async function runValidate(input, context) {
                 command: "forge.validate",
                 profileId: "",
                 artifacts: [],
+                allPassed: false,
             },
             exitCode: 1,
             summary: "No active profile found. Set `profile` in forge.yaml or use --profile <id>.",
@@ -37,14 +90,34 @@ export async function runValidate(input, context) {
                 command: "forge.validate",
                 profileId: profile.id,
                 artifacts: [],
+                allPassed: false,
             },
             exitCode: 1,
             summary: `Profile ${profile.id} does not declare any artifacts.`,
             nextSteps: [{ action: `Add artifacts section to profile ${profile.id}`, kind: "required" }],
         };
     }
+    if (artifactFilter) {
+        const found = profile.artifacts.find((a) => a.id === artifactFilter);
+        if (!found) {
+            return {
+                data: {
+                    command: "forge.validate",
+                    profileId: profile.id,
+                    artifacts: [],
+                    allPassed: false,
+                },
+                exitCode: 1,
+                summary: `Artifact ${artifactFilter} not declared in profile ${profile.id}.`,
+                nextSteps: [{ action: `Check artifacts in profile ${profile.id}`, kind: "required" }],
+            };
+        }
+    }
+    const artifactsToValidate = artifactFilter
+        ? profile.artifacts.filter((a) => a.id === artifactFilter)
+        : profile.artifacts;
     if (dryRun) {
-        const commands = profile.artifacts
+        const commands = artifactsToValidate
             .filter((a) => a.validate)
             .map((a) => ({ artifactId: a.id, command: a.validate.command }));
         logger.info(`[dry-run] forge.validate — profile: ${profile.id}`);
@@ -59,34 +132,43 @@ export async function runValidate(input, context) {
                     id: c.artifactId,
                     command: c.command,
                     exitCode: 0,
+                    passed: true,
+                    violations: [],
                     stdout: "",
                     stderr: "",
                 })),
+                allPassed: true,
             },
             summary: `[dry-run] ${commands.length} validate command(s) resolved`,
         };
     }
     const results = [];
-    let hasFailure = false;
-    for (const artifact of profile.artifacts) {
+    for (const artifact of artifactsToValidate) {
         if (!artifact.validate) {
             logger.warn(`Skipping artifact ${artifact.id}: no validate command declared`);
             results.push({
                 id: artifact.id,
                 command: "",
                 exitCode: 0,
+                passed: true,
+                violations: [],
                 stdout: "",
                 stderr: "skipped: no validate command",
             });
             continue;
         }
         const cmd = artifact.validate.command;
+        const outputFormat = artifact.validate.outputFormat;
+        const violationPattern = artifact.validate.violationPattern;
         try {
-            const { stdout, stderr } = await execAsync(cmd, { cwd: workspaceRoot });
+            const { stdout, stderr } = await execAsync(cmd, { cwd: workspaceRoot, timeout: 30_000 });
+            const violations = parseViolations(stdout + "\n" + stderr, outputFormat, violationPattern);
             results.push({
                 id: artifact.id,
                 command: cmd,
                 exitCode: 0,
+                passed: true,
+                violations,
                 stdout,
                 stderr,
             });
@@ -94,27 +176,33 @@ export async function runValidate(input, context) {
         }
         catch (err) {
             const e = err;
+            const rawStdout = e.stdout ?? "";
+            const rawStderr = e.stderr ?? e.message;
+            const violations = parseViolations(rawStdout + "\n" + rawStderr, outputFormat, violationPattern);
             results.push({
                 id: artifact.id,
                 command: cmd,
                 exitCode: e.code ?? 1,
-                stdout: e.stdout ?? "",
-                stderr: e.stderr ?? e.message,
+                passed: false,
+                violations,
+                stdout: rawStdout,
+                stderr: rawStderr,
             });
-            hasFailure = true;
             logger.error(`  ${artifact.id}: FAILED (exit ${e.code ?? 1})`);
         }
     }
+    const allPassed = results.every((r) => r.passed);
     return {
         data: {
             command: "forge.validate",
             profileId: profile.id,
             artifacts: results,
+            allPassed,
         },
-        exitCode: hasFailure ? 1 : 0,
-        summary: hasFailure
-            ? `forge.validate: ${results.filter((r) => r.exitCode !== 0).length} artifact(s) failed`
-            : `forge.validate: all ${results.length} artifact(s) passed`,
+        exitCode: allPassed ? 0 : 1,
+        summary: allPassed
+            ? `forge.validate: all ${results.length} artifact(s) passed`
+            : `forge.validate: ${results.filter((r) => !r.passed).length} artifact(s) failed`,
     };
 }
 //# sourceMappingURL=validate.js.map

package/dist/os/core/handlers/validate.js.map

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

package/dist/src/onboarding/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/onboarding/doctor.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAgBrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC5C;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AA8rBD,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6JD,wBAAsB,SAAS,CAC7B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAuPpL"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/onboarding/doctor.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAkBrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC5C;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAosBD,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6JD,wBAAsB,SAAS,CAC7B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAuPpL"}

package/dist/src/onboarding/doctor.js

@@ -30,8 +30,10 @@ import { parse as parseYaml } from "yaml";
 import { resolveForgeRoot, loadForgeConfig, resolveBinding, resolveTerminology, FORGE_CLI_BINDING_DEFAULTS, resolvePmRunner } from "../config/forge-config.js";
 import { FORGE_SKILLS, discoverPackSkills } from "../registry.js";
 import { discoverWorkspaces } from "./workspace-discovery.js";
-import { buildNestedAgentsMd } from "./nested-agents-templates.js";
+import { buildNestedAgentsMd, selectNestedTemplate } from "./nested-agents-templates.js";
+import { readPackageInfo } from "./nested-agents-generate.js";
 import { listStackProfiles } from "../profiles/stack-profile.js";
+import { resolveAllTerminology } from "../profiles/terminology-utils.js";
 import { TERMINOLOGY_DEFAULTS } from "../profiles/profile-schema.js";
 import { runProfileValidate } from "./profile-validate.js";
 import { parseKnowledgeFile } from "../knowledge/index.js";
@@ -621,8 +623,14 @@ async function checkNestedAgentsMd(workspaceRoot, workspaceTypes) {
             continue;
         }
         // Stale check: compare in-memory render to committed file
+        // Must match the generate pipeline: readPackageInfo + buildNestedAgentsMd + selectNestedTemplate
         try {
-            const expected = buildNestedAgentsMd(ws, config);
+            const packageInfo = readPackageInfo(workspaceRoot, ws.path);
+            const fallback = buildNestedAgentsMd(ws, config, packageInfo);
+            const profile = config.profile;
+            const terminology = resolveAllTerminology(config, profile);
+            const wsType = workspaceTypes?.find((wt) => wt.id === ws.type);
+            const expected = selectNestedTemplate(wsType, profile, terminology, fallback);
             const actual = await readFile(join(workspaceRoot, ws.path, "AGENTS.md"), "utf8");
             if (expected !== actual) {
                 stale++;