@noodleseed/one 0.113.0 → 0.114.0

package/dist/agents-doctor.js

@@ -0,0 +1,247 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { AGENT_KIT_VERSION, contentSha256, reconcileManagedBlock, renderAgentFiles, } from '@noodle-borg/agent-kit';
+import { commandOnPath, displayAgentName, isSkillsUpdateContext, pluginRequiredAgentKitVersion, resolveAgentProjectMetadata, } from './agent-command-context.js';
+import { compileProjectProductSkill } from './agent-product-skill.js';
+import { doctorProjectProductSkill } from './agent-product-skill-doctor.js';
+import { readManagedSkillState } from './agent-skills-state.js';
+import { printJsonFailure, printJsonOk } from './commands/output.js';
+import { configDir } from './config.js';
+import { fetchLatestAgentKitVersion, loadCachedAgentKit, skillStaleness } from './skills-update.js';
+export function staleAgentContextError(checks) {
+    return {
+        code: 'agent_context_stale',
+        message: 'agent context is stale or missing',
+        next: 'noodle agents setup --write',
+        detail: { checks },
+    };
+}
+export async function runAgentDoctor(args, env, configLocation) {
+    const pluginRequiredVersion = pluginRequiredAgentKitVersion(env);
+    const expectedSkillsVersion = pluginRequiredVersion ??
+        (isSkillsUpdateContext(env) ? await fetchLatestAgentKitVersion() : undefined);
+    const pluginPinnedKit = pluginRequiredVersion !== undefined && pluginRequiredVersion !== AGENT_KIT_VERSION
+        ? loadCachedAgentKit({
+            cacheDir: join(configDir(configLocation), 'cache', 'agent-kit'),
+            version: pluginRequiredVersion,
+        })
+        : undefined;
+    const projectMetadata = resolveAgentProjectMetadata(args.project);
+    const workflowChecks = args.agents.flatMap((target) => {
+        const bundled = renderAgentFiles({ targets: [target], project: projectMetadata });
+        const state = readManagedSkillState(args.project, target);
+        const useOwnedSnapshot = pluginPinnedKit === undefined &&
+            state !== undefined &&
+            state.packageVersion !== AGENT_KIT_VERSION;
+        const generatedBase = pluginPinnedKit !== undefined
+            ? pluginPinnedKit.manifest.files
+                .filter((file) => file.agentTarget === target)
+                .map((file) => ({
+                path: file.installedPath,
+                mode: 'generated-file',
+                skill: file.skill,
+                skillVersion: file.skillVersion,
+                expectedSha256: file.sha256,
+            }))
+            : useOwnedSnapshot
+                ? state.files.map((file) => ({
+                    path: file.path,
+                    mode: 'generated-file',
+                    skill: file.skill,
+                    skillVersion: file.skillVersion,
+                    expectedSha256: file.sha256,
+                }))
+                : bundled
+                    .filter((file) => file.mode === 'generated-file')
+                    .map((file) => ({
+                    path: file.path,
+                    mode: file.mode,
+                    skill: file.skill ?? failMissingSkillIdentity(file.path),
+                    skillVersion: file.skillVersion ?? failMissingSkillIdentity(file.path),
+                    expectedSha256: contentSha256(file.content),
+                }));
+        const generated = pluginPinnedKit === undefined && state !== undefined && !useOwnedSnapshot
+            ? [
+                ...generatedBase,
+                ...state.files
+                    .filter((file) => !generatedBase.some((candidate) => candidate.path === file.path))
+                    .map((file) => ({
+                    path: file.path,
+                    mode: 'generated-file',
+                    skill: file.skill,
+                    skillVersion: file.skillVersion,
+                    expectedSha256: file.sha256,
+                })),
+            ]
+            : generatedBase;
+        const files = [
+            ...bundled
+                .filter((file) => file.mode === 'managed-block')
+                .map((file) => ({
+                path: file.path,
+                mode: file.mode,
+                expectedContent: file.content,
+            })),
+            ...generated,
+        ];
+        const referenceBaselineAvailable = pluginRequiredVersion === undefined ||
+            pluginRequiredVersion === AGENT_KIT_VERSION ||
+            pluginPinnedKit !== undefined;
+        return [
+            {
+                name: `${displayAgentName(target)} binary`,
+                level: commandOnPath(target === 'codex' ? 'codex' : 'claude', env) ? 'PASS' : 'WARN',
+                message: target === 'codex' ? 'codex' : 'claude',
+            },
+            ...files.map((file) => inspectWorkflowFile({
+                project: args.project,
+                target,
+                file,
+                pluginRequiredVersion,
+                expectedSkillsVersion,
+                referenceBaselineAvailable,
+            })),
+        ];
+    });
+    const checks = [
+        ...workflowChecks,
+        ...doctorProjectProductSkill({
+            project: args.project,
+            targets: args.agents,
+            compilation: await compileProjectProductSkill(args.project),
+        }),
+    ];
+    const ok = checks.every((check) => check.level !== 'FAIL');
+    if (args.json) {
+        if (ok) {
+            const stale = checks.some((check) => check.level === 'WARN');
+            printJsonOk({
+                checks,
+                restartRequired: false,
+                stale,
+                ...(stale
+                    ? {
+                        nextCommands: [
+                            {
+                                command: 'noodle agents setup --write',
+                                reason: 'refresh stale or missing generated agent context',
+                            },
+                        ],
+                    }
+                    : {}),
+            });
+            return 0;
+        }
+        return printJsonFailure(staleAgentContextError(checks), 1);
+    }
+    for (const check of checks)
+        console.log(`${check.level} ${check.name}: ${check.message}`);
+    console.log('Next: noodle agents setup --write');
+    return ok ? 0 : 1;
+}
+function inspectWorkflowFile(input) {
+    const path = join(input.project, input.file.path);
+    if (!existsSync(path)) {
+        return {
+            name: input.file.path,
+            level: 'WARN',
+            message: 'run noodle agents setup --write',
+        };
+    }
+    if (input.file.mode === 'managed-block' && input.file.expectedContent !== undefined) {
+        const reconciliation = reconcileManagedBlock({
+            existing: readFileSync(path, 'utf8'),
+            block: input.file.expectedContent.trimEnd(),
+        });
+        if (reconciliation.action !== 'unchanged') {
+            return {
+                name: input.file.path,
+                level: 'WARN',
+                message: 'modified or stale; run noodle agents setup --write',
+            };
+        }
+    }
+    const skillVersion = input.file.mode === 'generated-file' && input.file.skill !== undefined
+        ? readInstalledSkillVersion(join(input.project, `${input.target === 'codex' ? '.agents' : '.claude'}/skills/${input.file.skill}/SKILL.md`))
+        : undefined;
+    if (input.file.mode === 'generated-file' && input.file.path.endsWith('/SKILL.md')) {
+        const comparisonVersion = input.pluginRequiredVersion ?? input.expectedSkillsVersion;
+        const pluginVersionMismatch = input.pluginRequiredVersion !== undefined && skillVersion !== input.pluginRequiredVersion;
+        const staleness = pluginVersionMismatch
+            ? 'stale'
+            : skillStaleness(skillVersion, comparisonVersion);
+        const expectedVersionLabel = input.pluginRequiredVersion !== undefined ? 'plugin-required' : 'registry';
+        if (staleness !== 'stale' && input.file.expectedSha256 !== undefined) {
+            const current = contentSha256(readFileSync(path, 'utf8')) === input.file.expectedSha256;
+            if (!current) {
+                return {
+                    name: input.file.path,
+                    level: 'WARN',
+                    message: 'modified; run noodle agents setup --write',
+                };
+            }
+        }
+        return {
+            name: input.file.path,
+            level: staleness === 'stale' ? 'WARN' : 'PASS',
+            message: staleness === 'stale'
+                ? pluginVersionMismatch
+                    ? `installed v${skillVersion ?? '?'} does not match ${expectedVersionLabel} v${comparisonVersion}`
+                    : `installed v${skillVersion ?? '?'} is older than ${expectedVersionLabel} v${comparisonVersion}`
+                : staleness === 'current'
+                    ? 'current'
+                    : 'present',
+        };
+    }
+    if (input.file.mode === 'generated-file' &&
+        !input.file.path.endsWith('/SKILL.md') &&
+        input.pluginRequiredVersion !== undefined &&
+        !input.referenceBaselineAvailable &&
+        skillVersion === input.pluginRequiredVersion) {
+        return {
+            name: input.file.path,
+            level: 'WARN',
+            message: `plugin-required v${input.pluginRequiredVersion} cache unavailable; run noodle agents setup --write`,
+        };
+    }
+    if (input.file.mode === 'generated-file' &&
+        skillVersion === input.file.skillVersion &&
+        !input.file.path.endsWith('/SKILL.md')) {
+        if (!input.referenceBaselineAvailable) {
+            return {
+                name: input.file.path,
+                level: 'WARN',
+                message: `plugin-required v${input.pluginRequiredVersion} cache unavailable; run noodle agents setup --write`,
+            };
+        }
+        const current = input.file.expectedSha256 !== undefined &&
+            contentSha256(readFileSync(path, 'utf8')) === input.file.expectedSha256;
+        return {
+            name: input.file.path,
+            level: current ? 'PASS' : 'WARN',
+            message: current ? 'current' : 'modified; run noodle agents setup --write',
+        };
+    }
+    return { name: input.file.path, level: 'PASS', message: 'present' };
+}
+function readInstalledSkillVersion(path) {
+    try {
+        const content = readFileSync(path, 'utf8');
+        const metadata = /^<!-- noodle-skill version:([^ ]+) hash:[a-f0-9]{16} -->$/m.exec(content);
+        if (metadata?.[1])
+            return metadata[1];
+        const lines = content.split('\n');
+        const close = lines.indexOf('---', 1);
+        if (close < 0)
+            return undefined;
+        const frontmatter = lines.slice(1, close).join('\n');
+        return /^version:\s*(.+)$/m.exec(frontmatter)?.[1]?.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function failMissingSkillIdentity(path) {
+    throw new Error(`generated skill file is missing registry identity: ${path}`);
+}
+//# sourceMappingURL=agents-doctor.js.map

package/dist/agents-doctor.js.map

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

package/dist/agents.d.ts

@@ -1,6 +1,8 @@
 import { type AgentTarget, type SkillRegistry } from '@noodle-borg/agent-kit';
-import { type JsonError } from './commands/output.js';
+import { type ProductSkillSetupReport } from './agent-product-skill.js';
 import { type ConfigLocation } from './config.js';
+export type { AgentDoctorCheck } from './agents-doctor.js';
+export { staleAgentContextError } from './agents-doctor.js';
 interface AgentArgs {
     readonly action: string | undefined;
     /** undefined = no --agents flag; the project's noodle.json `agents` list (else both) is the default. */
@@ -41,23 +43,12 @@ export interface AgentSetupReport {
     readonly targets: readonly AgentTarget[];
     readonly files: readonly AgentFileAction[];
     readonly restartHints: readonly string[];
+    readonly productSkill?: ProductSkillSetupReport;
 }
-/** A single `agents doctor` diagnostic line: a named check with a level and a human message. */
-export interface AgentDoctorCheck {
-    readonly name: string;
-    readonly level: string;
-    readonly message: string;
-}
-/**
- * The failure envelope's `error` that `agents doctor --json` emits when the agent context is unhealthy
- * (a `FAIL`-level check). Kept as one builder so the machine contract has a single source of truth.
- */
-export declare function staleAgentContextError(checks: readonly AgentDoctorCheck[]): JsonError;
 export declare function runAgents(rest: readonly string[], env?: NodeJS.ProcessEnv, configLocation?: ConfigLocation): Promise<number>;
 export declare function setupAgents(args: AgentSetupInput): AgentSetupReport;
 /** Resolve the active Agent Kit profile before rendering any project agent files. */
 export declare function setupAgentsWithResolvedSkills(args: Omit<AgentSetupInput, 'skillsOverride'> & {
     readonly refresh?: boolean;
 }, env?: NodeJS.ProcessEnv, configLocation?: ConfigLocation): Promise<AgentSetupReport>;
-export {};
 //# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

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