@open-agent-toolkit/cli 0.2.63 → 0.2.64

package/dist/commands/init/tools/index.js

@@ -11,9 +11,11 @@ import { canonicalPathsForPacks, getInstalledCanonicalPaths, setInstalledCanonic
 import { packScopeFactsFromInventory, projectPackEvidence, } from '../../tools/shared/pack-evidence.js';
 import { inventoryPack, } from '../../tools/shared/pack-inventory.js';
 import { reconcilePackLifecycles, } from '../../tools/shared/pack-lifecycle.js';
-import { evaluatePackLifecycleOutcome, resolveAdditivePackScopeSelection, } from '../../tools/shared/pack-lifecycle-outcome.js';
+import { evaluatePackLifecycleOutcome, notRunProviderSyncOutcome, providerSyncOutcomeFromAutoSync, resolveAdditivePackScopeSelection, } from '../../tools/shared/pack-lifecycle-outcome.js';
 import { getPackDefinition } from '../../tools/shared/pack-manifest.js';
+import { lifecycleProviderEvidence, withLifecycleProviderEvidence, } from '../../tools/shared/pack-provider-evidence.js';
 import { reconcileProjectToolsConfig } from '../../tools/shared/project-tools-config.js';
+import { resolveProviderScopeContexts } from '../../tools/shared/provider-context.js';
 import { scanTools } from '../../tools/shared/scan-tools.js';
 import { readOatConfig, resolveLocalPaths, writeOatConfig, } from '../../../config/oat-config.js';
 import { resolveAssetsRoot } from '../../../fs/assets.js';
@@ -620,6 +622,10 @@ export async function runInitTools(context, dependencies, explicitProjectGuidanc
     let attemptedPacks = [];
     let attemptedSelections = [];
     let lifecycleOutcomes = [];
+    // Resolved once and reused by every outcome in this run, including the
+    // failure path: activation and capability are knowable even when the
+    // canonical apply failed.
+    let providerContexts = [];
     try {
         const userRoot = dependencies.resolveScopeRoot('user', context.cwd, context.home);
         const assetsRoot = await dependencies.resolveAssetsRoot();
@@ -631,6 +637,12 @@ export async function runInitTools(context, dependencies, explicitProjectGuidanc
             if (context.scope === 'project')
                 throw error;
         }
+        providerContexts = await resolveProviderScopeContexts({
+            scopeRoots: {
+                ...(projectRoot ? { project: projectRoot } : {}),
+                user: userRoot,
+            },
+        });
         const initialPackStates = await loadInstalledPackStates(projectRoot, userRoot, assetsRoot, dependencies);
         const selectedPacks = context.interactive
             ? ((await dependencies.selectManyWithAbort('Select tool packs to install', buildPackChoices(initialPackStates), { interactive: context.interactive })) ?? [])
@@ -706,11 +718,17 @@ export async function runInitTools(context, dependencies, explicitProjectGuidanc
                 lifecycleOutcomes = finalEvidence.map((evidence) => {
                     const packResults = lifecycle.filter(({ request }) => request.pack === evidence.pack);
                     const selection = attemptedSelections.find(({ pack }) => pack === evidence.pack);
+                    const providers = lifecycleProviderEvidence({
+                        pack: evidence.pack,
+                        scopedInventories: evidence.canonical?.scopes ?? [],
+                        providerContexts,
+                        scopes: selection.targetScopes,
+                    });
                     return evaluatePackLifecycleOutcome({
                         selection,
                         lifecycle: packResults,
-                        sync: { scopes: [], status: 'not-run', providers: [] },
-                        finalEvidence: evidence,
+                        sync: notRunProviderSyncOutcome(providers, 'Auto-sync has not run for this operation'),
+                        finalEvidence: withLifecycleProviderEvidence(evidence, providers),
                     });
                 });
                 for (const evidence of finalEvidence) {
@@ -1011,21 +1029,24 @@ export async function runInitTools(context, dependencies, explicitProjectGuidanc
         const guidancePlan = await applyProjectGuidance(plannedGuidance, dependencies);
         if (dependencies.syncAfterInstall) {
             const sync = await dependencies.syncAfterInstall(affectedScopesList, context, canonicalPathsForPacks(selectedPacks));
-            lifecycleOutcomes = lifecycleOutcomes.map((outcome) => evaluatePackLifecycleOutcome({
-                selection: outcome.selection,
-                lifecycle: outcome.canonical.results,
-                sync: {
-                    scopes: sync.scopes.filter((scope) => outcome.selection.targetScopes.includes(scope)),
-                    status: sync.scopes.length === 0
-                        ? 'not-run'
-                        : sync.synced
-                            ? 'complete'
-                            : 'failed',
-                    providers: [],
-                    ...(sync.error ? { error: sync.error } : {}),
-                },
-                finalEvidence: outcome.finalEvidence,
-            }));
+            lifecycleOutcomes = lifecycleOutcomes.map((outcome) => {
+                const providers = lifecycleProviderEvidence({
+                    pack: outcome.selection.pack,
+                    scopedInventories: outcome.finalEvidence?.canonical?.scopes ?? [],
+                    providerContexts,
+                    scopes: outcome.selection.targetScopes,
+                    sync,
+                });
+                return evaluatePackLifecycleOutcome({
+                    selection: outcome.selection,
+                    lifecycle: outcome.canonical.results,
+                    sync: providerSyncOutcomeFromAutoSync({
+                        ...sync,
+                        scopes: sync.scopes.filter((scope) => outcome.selection.targetScopes.includes(scope)),
+                    }, providers),
+                    finalEvidence: withLifecycleProviderEvidence(outcome.finalEvidence, providers),
+                });
+            });
         }
         lastRunInitToolsMetadata = {
             affectedScopes: affectedScopesList,
@@ -1062,11 +1083,11 @@ export async function runInitTools(context, dependencies, explicitProjectGuidanc
                                     targetScopes: [],
                                 },
                                 canonical: { status: 'failed', results: [] },
-                                sync: {
-                                    scopes: [],
-                                    status: 'not-run',
-                                    providers: [],
-                                },
+                                sync: notRunProviderSyncOutcome(lifecycleProviderEvidence({
+                                    pack,
+                                    scopedInventories: [],
+                                    providerContexts,
+                                }), 'Canonical apply failed before auto-sync'),
                                 finalEvidence: null,
                                 status: 'failed',
                                 recovery: [{ code: 'canonical-apply-failed', message }],
@@ -1159,6 +1180,7 @@ function createReconciledPackCommand(pack, dependencies) {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         let lifecycleOutcome = null;
         let selection = null;
+        let providerContexts = [];
         try {
             const explicitProjectGuidance = pack === 'workflows'
                 ? commandProjectGuidanceChoice(command)
@@ -1189,6 +1211,9 @@ function createReconciledPackCommand(pack, dependencies) {
                 action: 'install',
             })));
             const results = await dependencies.reconcilePacks(requests);
+            providerContexts = await resolveProviderScopeContexts({
+                scopeRoots: Object.fromEntries(requests.map(({ scope, scopeRoot }) => [scope, scopeRoot])),
+            });
             let finalEvidence = null;
             if (dependencies.inventoryPack) {
                 finalEvidence = await loadPackEvidence(pack, requests.some(({ scope }) => scope === 'project')
@@ -1198,7 +1223,12 @@ function createReconciledPackCommand(pack, dependencies) {
             lifecycleOutcome = evaluatePackLifecycleOutcome({
                 selection,
                 lifecycle: results,
-                sync: { scopes: [], status: 'not-run', providers: [] },
+                sync: notRunProviderSyncOutcome(lifecycleProviderEvidence({
+                    pack,
+                    scopedInventories: finalEvidence?.canonical?.scopes ?? [],
+                    providerContexts,
+                    scopes,
+                }), 'Auto-sync has not run for this operation'),
                 finalEvidence,
             });
             if (finalEvidence)
@@ -1213,20 +1243,18 @@ function createReconciledPackCommand(pack, dependencies) {
                     .filter(({ plan }) => plan.operations.length > 0)
                     .map(({ request }) => request.scope);
                 const sync = await dependencies.syncAfterInstall(changedScopes, context, canonicalPathsForPacks([pack]));
+                const providers = lifecycleProviderEvidence({
+                    pack,
+                    scopedInventories: finalEvidence?.canonical?.scopes ?? [],
+                    providerContexts,
+                    scopes,
+                    sync,
+                });
                 lifecycleOutcome = evaluatePackLifecycleOutcome({
                     selection,
                     lifecycle: results,
-                    sync: {
-                        scopes: sync.scopes,
-                        status: sync.scopes.length === 0
-                            ? 'not-run'
-                            : sync.synced
-                                ? 'complete'
-                                : 'failed',
-                        providers: [],
-                        ...(sync.error ? { error: sync.error } : {}),
-                    },
-                    finalEvidence,
+                    sync: providerSyncOutcomeFromAutoSync(sync, providers),
+                    finalEvidence: withLifecycleProviderEvidence(finalEvidence, providers),
                 });
             }
             // Project-scope placement installs capability only. The
@@ -1316,7 +1344,11 @@ function createReconciledPackCommand(pack, dependencies) {
                     targetScopes: [],
                 },
                 canonical: { status: 'failed', results: [] },
-                sync: { scopes: [], status: 'not-run', providers: [] },
+                sync: notRunProviderSyncOutcome(lifecycleProviderEvidence({
+                    pack,
+                    scopedInventories: [],
+                    providerContexts,
+                }), 'Canonical apply failed before auto-sync'),
                 finalEvidence: null,
                 status: 'failed',
                 recovery: [{ code: 'canonical-apply-failed', message }],

package/dist/commands/shared/frontmatter.d.ts

@@ -56,6 +56,57 @@ export declare function parseFrontmatterScalarFields(frontmatter: string, fields
  */
 export declare function parseGeneratedTime(value: string): number;
 export declare function parseFrontmatterField(filePath: string, field: string): Promise<string>;
+/**
+ * A skill or agent frontmatter block reduced to the fields that carry a
+ * version, in the one shape every version read consumes.
+ *
+ * `malformed` marks input that cannot be trusted to carry a version at all:
+ * the YAML document has errors (including duplicate keys), or `metadata` is
+ * present but is not a map. A malformed block resolves to `null` rather than
+ * to a guessed value.
+ *
+ * `unusableVersionDeclaration` records that a `version` key was present at
+ * either position but produced no usable value (empty, or a non-string scalar
+ * such as `1.10`, which YAML reads as the number 1.1). Validation needs that
+ * distinction: a skill that declares nothing is unversioned, while a skill
+ * that declares an unusable version is broken — including when the *other*
+ * position still resolves. It is carried here so no caller has to re-read the
+ * block with a regex.
+ */
+export interface ParsedSkillFrontmatter {
+    version?: string;
+    metadata?: {
+        version?: string;
+    };
+    malformed: boolean;
+    unusableVersionDeclaration: boolean;
+}
+export interface SkillVersionConflict {
+    metadata: string;
+    topLevel: string;
+}
+export interface ResolvedSkillVersion {
+    version: string;
+    source: 'metadata' | 'top-level';
+    conflict?: SkillVersionConflict;
+}
+/**
+ * Parse a raw frontmatter block into the shared version-carrying shape.
+ *
+ * Uses the `yaml` package already imported by this module so that
+ * `metadata.version` is read by a real YAML parser; a regex or
+ * indentation-based reader cannot tell a nested key from a top-level one.
+ */
+export declare function parseSkillFrontmatter(block: string): ParsedSkillFrontmatter;
+/**
+ * Resolve the canonical version with `metadata.version` taking precedence over
+ * the deprecated top-level `version` alias.
+ *
+ * When both are present and differ the resolver still reports the
+ * metadata value, but flags the conflict so callers that must not guess (the
+ * validators, canonical role identity) can reject it.
+ */
+export declare function resolveSkillVersion(parsed: ParsedSkillFrontmatter): ResolvedSkillVersion | null;
 export declare function getSkillVersion(skillDir: string): Promise<string | null>;
 export declare function getAgentVersion(agentPath: string): Promise<string | null>;
 //# sourceMappingURL=frontmatter.d.ts.map

package/dist/commands/shared/frontmatter.d.ts.map

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

package/dist/commands/shared/frontmatter.js

@@ -201,13 +201,125 @@ export async function parseFrontmatterField(filePath, field) {
         return '';
     }
 }
+/**
+ * Read a frontmatter value that is a plain, undecorated string.
+ *
+ * A tagged (`!!str 1.2.3`) or anchored (`&pin 1.2.3`) scalar is rejected by the
+ * explicit checks below, and an aliased value (`*pin`) is rejected because an
+ * alias node is not a scalar at all. Folded (`>-`) and literal (`|`) block
+ * scalars are none of those: they are ordinary string scalars and resolve
+ * normally.
+ *
+ * Non-string scalars are deliberately rejected rather than stringified: YAML
+ * reads `version: 1.10` as the number `1.1`, so accepting numbers would report
+ * a version the author never wrote.
+ */
+function scalarStringValue(node) {
+    if (!isScalar(node) ||
+        node.anchor !== undefined ||
+        node.tag !== undefined ||
+        typeof node.value !== 'string') {
+        return undefined;
+    }
+    const trimmed = node.value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function hasKey(map, key) {
+    return map.items.some((pair) => isScalar(pair.key) && pair.key.value === key);
+}
+function uniqueMapValue(map, key) {
+    const matches = map.items.filter((pair) => isScalar(pair.key) && pair.key.value === key);
+    return matches.length === 1 ? matches[0]?.value : undefined;
+}
+/**
+ * Parse a raw frontmatter block into the shared version-carrying shape.
+ *
+ * Uses the `yaml` package already imported by this module so that
+ * `metadata.version` is read by a real YAML parser; a regex or
+ * indentation-based reader cannot tell a nested key from a top-level one.
+ */
+export function parseSkillFrontmatter(block) {
+    const document = YAML.parseDocument(block, { uniqueKeys: true });
+    if (document.errors.length > 0) {
+        return { malformed: true, unusableVersionDeclaration: false };
+    }
+    if (!isMap(document.contents)) {
+        return { malformed: false, unusableVersionDeclaration: false };
+    }
+    const version = scalarStringValue(uniqueMapValue(document.contents, 'version'));
+    const parsed = {
+        malformed: false,
+        unusableVersionDeclaration: version === undefined && hasKey(document.contents, 'version'),
+    };
+    if (version !== undefined) {
+        parsed.version = version;
+    }
+    const metadata = uniqueMapValue(document.contents, 'metadata');
+    if (metadata !== undefined) {
+        if (!isMap(metadata)) {
+            return {
+                malformed: true,
+                unusableVersionDeclaration: parsed.unusableVersionDeclaration,
+            };
+        }
+        const metadataVersion = scalarStringValue(uniqueMapValue(metadata, 'version'));
+        parsed.unusableVersionDeclaration =
+            parsed.unusableVersionDeclaration ||
+                (metadataVersion === undefined && hasKey(metadata, 'version'));
+        parsed.metadata =
+            metadataVersion === undefined ? {} : { version: metadataVersion };
+    }
+    return parsed;
+}
+/**
+ * Resolve the canonical version with `metadata.version` taking precedence over
+ * the deprecated top-level `version` alias.
+ *
+ * When both are present and differ the resolver still reports the
+ * metadata value, but flags the conflict so callers that must not guess (the
+ * validators, canonical role identity) can reject it.
+ */
+export function resolveSkillVersion(parsed) {
+    if (parsed.malformed) {
+        return null;
+    }
+    const metadataVersion = parsed.metadata?.version;
+    const topLevel = parsed.version;
+    if (metadataVersion !== undefined) {
+        if (topLevel !== undefined && topLevel !== metadataVersion) {
+            return {
+                version: metadataVersion,
+                source: 'metadata',
+                conflict: { metadata: metadataVersion, topLevel },
+            };
+        }
+        return { version: metadataVersion, source: 'metadata' };
+    }
+    if (topLevel !== undefined) {
+        return { version: topLevel, source: 'top-level' };
+    }
+    return null;
+}
+async function readResolvedVersion(filePath) {
+    let content;
+    try {
+        content = await readFile(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const block = getFrontmatterBlock(content);
+    if (!block)
+        return null;
+    return resolveSkillVersion(parseSkillFrontmatter(block));
+}
 export async function getSkillVersion(skillDir) {
-    // parseFrontmatterField() returns '' when SKILL.md is missing or unreadable,
-    // so read failures are normalized to null here.
-    const version = await parseFrontmatterField(join(skillDir, 'SKILL.md'), 'version');
-    return version.length > 0 ? version : null;
+    // Missing, unreadable, malformed, and empty frontmatter all normalize to
+    // null here so callers keep one "no comparable version" contract.
+    const resolved = await readResolvedVersion(join(skillDir, 'SKILL.md'));
+    return resolved?.version ?? null;
 }
 export async function getAgentVersion(agentPath) {
-    const version = await parseFrontmatterField(agentPath, 'version');
-    return version.length > 0 ? version : null;
+    const resolved = await readResolvedVersion(agentPath);
+    return resolved?.version ?? null;
 }

package/dist/commands/status/index.d.ts.map

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

package/dist/commands/status/index.js

@@ -274,7 +274,7 @@ function shouldReportPjmAdoption(adoption, states) {
     const pjm = states.find(({ pack }) => pack === 'project-management');
     return (pjm?.scopes ?? []).some(({ scope }) => scope === 'project');
 }
-async function collectPackReport(scopeRoots, unavailableScopes, userAgentCoverage, dependencies) {
+async function collectPackReport(scopeRoots, unavailableScopes, userAgentCoverage, providerContexts, dependencies) {
     const roots = {
         ...(scopeRoots.has('project')
             ? { projectRoot: scopeRoots.get('project') }
@@ -322,7 +322,7 @@ async function collectPackReport(scopeRoots, unavailableScopes, userAgentCoverag
     const states = inventories
         .map((inventory) => toStatusPackState(inventory, roots))
         .filter((state) => state !== null);
-    const evidence = packEvidenceBlock(inventories.map((canonical) => projectRenderablePackEvidence(canonical, roots)));
+    const evidence = packEvidenceBlock(inventories.map((canonical) => projectRenderablePackEvidence(canonical, roots, providerContexts)));
     const projectRoot = scopeRoots.get('project');
     if (!projectRoot) {
         return {
@@ -699,7 +699,9 @@ async function runStatusCommand(context, dependencies, options = {}) {
         ? 'all'
         : scopeCollections.some((collection) => collection.userAgentMaterializationCoverage === 'bundled')
             ? 'bundled'
-            : 'none', dependencies);
+            : 'none', scopeCollections
+        .map(({ providerContext }) => providerContext)
+        .filter((providerContext) => providerContext !== null), dependencies);
     if (context.json) {
         const payload = {
             scope: context.scope,

package/dist/commands/sync/index.d.ts

@@ -1,3 +1,4 @@
+import { type CommandContext } from '../../app/command-context.js';
 import { type SyncConfig } from '../../config/index.js';
 import { type ProviderScopeContext } from '../../providers/shared/index.js';
 import { type CanonicalScanTarget, type ConcreteScope } from '../../shared/types.js';
@@ -15,5 +16,18 @@ type ContextualSyncDependencies = Omit<SyncCommandDependencies, 'computeSyncPlan
     }) => Promise<ProviderScopeContext>;
 };
 export declare function createSyncCommand(overrides?: Partial<ContextualSyncDependencies>): Command;
+/**
+ * Runs the sync command in-process against a caller-supplied context.
+ *
+ * The tools lifecycle uses this instead of spawning `oat sync --json` and
+ * parsing its stdout: the caller passes a JSON-capturing logger and receives
+ * the evidence object the sync run already builds, with no serialization
+ * round trip and no subprocess. Canonical path filters are validated here
+ * with the same rules the CLI flags use.
+ */
+export declare function runSyncInProcess(context: CommandContext, filter?: {
+    installedCanonicalPaths?: string[];
+    removedCanonicalPaths?: string[];
+}, overrides?: Partial<ContextualSyncDependencies>): Promise<void>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/sync/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,eAAe,CAAC;AAWvB,OAAO,EAOL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,EACV,aAAa,EAEb,uBAAuB,EAGxB,MAAM,cAAc,CAAC;AAEtB,KAAK,0BAA0B,GAAG,IAAI,CACpC,uBAAuB,EACvB,iBAAiB,GAAG,eAAe,CACpC,GAAG;IACF,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,KACrC,UAAU,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1D,eAAe,EAAE,CACf,IAAI,EAAE,UAAU,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAChE,sCAAsC,CAAC,EAAE,QAAQ,CAC/C,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAClC,CAAC;KACH,KACE,UAAU,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC5D,2BAA2B,CAAC,EAAE,CAAC,KAAK,EAAE;QACpC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,UAAU,CAAC;KACpB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC,CAAC;AA2fF,wBAAgB,iBAAiB,CAC/B,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CA+DT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYhF,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,eAAe,CAAC;AAWvB,OAAO,EAOL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,EACV,aAAa,EAEb,uBAAuB,EAGxB,MAAM,cAAc,CAAC;AAEtB,KAAK,0BAA0B,GAAG,IAAI,CACpC,uBAAuB,EACvB,iBAAiB,GAAG,eAAe,CACpC,GAAG;IACF,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,KACrC,UAAU,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1D,eAAe,EAAE,CACf,IAAI,EAAE,UAAU,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAChE,sCAAsC,CAAC,EAAE,QAAQ,CAC/C,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAClC,CAAC;KACH,KACE,UAAU,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC5D,2BAA2B,CAAC,EAAE,CAAC,KAAK,EAAE;QACpC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,UAAU,CAAC;KACpB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC,CAAC;AA2fF,wBAAgB,iBAAiB,CAC/B,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CA+DT;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE;IACP,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC,EACD,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/commands/sync/index.js

@@ -409,3 +409,24 @@ export function createSyncCommand(overrides = {}) {
                 : undefined);
     });
 }
+/**
+ * Runs the sync command in-process against a caller-supplied context.
+ *
+ * The tools lifecycle uses this instead of spawning `oat sync --json` and
+ * parsing its stdout: the caller passes a JSON-capturing logger and receives
+ * the evidence object the sync run already builds, with no serialization
+ * round trip and no subprocess. Canonical path filters are validated here
+ * with the same rules the CLI flags use.
+ */
+export async function runSyncInProcess(context, filter, overrides = {}) {
+    const installPaths = validateInstallCanonicalPaths(filter?.installedCanonicalPaths);
+    const removePaths = validateRemoveCanonicalPaths(filter?.removedCanonicalPaths);
+    if (installPaths?.length && removePaths?.length) {
+        throw new CliError('--install-canonical and --remove-canonical cannot be combined', 1);
+    }
+    await runSyncCommand(context, { ...defaultDependencies(), ...overrides }, installPaths?.length
+        ? { mode: 'install', paths: installPaths }
+        : removePaths?.length
+            ? { mode: 'remove', paths: removePaths }
+            : undefined);
+}

package/dist/commands/tools/info/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/info/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;AA2DrB,wBAAgB,sBAAsB,CACpC,YAAY,GAAE,oBAA0C,GACvD,OAAO,CAYT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/info/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;AAsErB,wBAAgB,sBAAsB,CACpC,YAAY,GAAE,oBAA0C,GACvD,OAAO,CAYT"}

package/dist/commands/tools/info/index.js

@@ -1,15 +1,18 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { buildCommandContext } from '../../../app/command-context.js';
-import { getFrontmatterBlock, getFrontmatterField, parseFrontmatterField, } from '../../shared/frontmatter.js';
+import { getFrontmatterBlock, getFrontmatterField, getSkillVersion, parseFrontmatterField, } from '../../shared/frontmatter.js';
 import { withScopeOption } from '../../shared/scope-option.js';
 import { readGlobalOptions } from '../../shared/shared.utils.js';
 import { scanTools } from '../../tools/shared/scan-tools.js';
+import { detectDrift, resolveExpectedSkillProjections } from '../../../drift/index.js';
 import { resolveAssetsRoot } from '../../../fs/assets.js';
 import { fileExists } from '../../../fs/io.js';
 import { resolveProjectRoot, resolveScopeRoot } from '../../../fs/paths.js';
+import { loadManifest } from '../../../manifest/manager.js';
 import { Command } from 'commander';
 import { runInfoTool, } from './info-tool.js';
+import { probeProviderPath, readProjectedSkillVersion } from './skill-views.js';
 async function getToolDetail(tool, scopeRoot) {
     if (tool.type === 'skill') {
         const skillDir = join(scopeRoot, '.agents', 'skills', tool.name);
@@ -59,6 +62,16 @@ const defaultDependencies = {
     },
     resolveAssetsRoot,
     getToolDetail,
+    // Read-only by construction: load, detect, probe, and read a version. No
+    // manifest save and no writer is reachable from `oat tools info`.
+    skillViews: {
+        loadManifest,
+        detectDrift: (entry, scopeRoot) => detectDrift(entry, scopeRoot),
+        resolveExpectedProjections: resolveExpectedSkillProjections,
+        pathExists: probeProviderPath,
+        getSkillVersion,
+        readProjectedVersion: readProjectedSkillVersion,
+    },
 };
 export function createToolsInfoCommand(dependencies = defaultDependencies) {
     return withScopeOption(new Command('info'))

package/dist/commands/tools/info/info-tool.d.ts

@@ -1,8 +1,11 @@
 import type { CommandContext } from '../../../app/command-context.js';
 import { type PackEvidenceBlockV1 } from '../../tools/shared/format-pack-inventory.js';
 import { type InventoryPackInput, type PackInventory } from '../../tools/shared/pack-inventory.js';
+import { type ProviderContextDependencies } from '../../tools/shared/provider-context.js';
 import type { ScanToolsOptions } from '../../tools/shared/scan-tools.js';
 import type { ToolInfo } from '../../tools/shared/types.js';
+import type { SkillViewDiagnosis } from '../../../drift/index.js';
+import { type SkillViewDependencies } from './skill-views.js';
 export interface ToolDetail extends ToolInfo {
     description: string | null;
     argumentHint: string | null;
@@ -15,12 +18,21 @@ export interface InfoToolDependencies {
     resolveAssetsRoot: () => Promise<string>;
     getToolDetail: (tool: ToolInfo, scopeRoot: string) => Promise<Omit<ToolDetail, keyof ToolInfo>>;
     inventoryPack?: (input: InventoryPackInput) => Promise<PackInventory>;
+    providerContext?: ProviderContextDependencies;
+    /**
+     * Read-only manifest, drift, and expected-projection access for the
+     * provider-view diagnostic. Omitted in unit harnesses that only exercise the
+     * inventory surface; the command wiring always supplies it.
+     */
+    skillViews?: SkillViewDependencies;
 }
 export interface InfoToolResult {
     found: boolean;
     tool: ToolDetail | null;
     pack: PackInventory | null;
     packEvidence?: PackEvidenceBlockV1;
+    /** Per-scope provider-view diagnosis; additive, skills only. */
+    providerViews?: SkillViewDiagnosis[];
 }
 export declare function runInfoTool(context: CommandContext, name: string, dependencies: InfoToolDependencies): Promise<InfoToolResult>;
 //# sourceMappingURL=info-tool.d.ts.map

package/dist/commands/tools/info/info-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info-tool.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/info/info-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,CACb,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAAC,cAAc,CAAC,CAuGzB"}
+{"version":3,"file":"info-tool.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/info/info-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,CACb,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,gEAAgE;IAChE,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACtC;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAAC,cAAc,CAAC,CA6JzB"}