@open-agent-toolkit/cli 0.2.26 → 0.2.27

package/dist/commands/project/archive/explainer-source-backlinks.d.ts

@@ -0,0 +1,18 @@
+declare const SOURCE_BACKLINK_CONTRACT_VERSION = "explainer-kit.source-backlinks/v1";
+export interface CanonicalSourceBacklink {
+    repository: string;
+    revision: string;
+    path: string;
+    lineRange: {
+        start: number;
+        end: number;
+    };
+    url: string;
+}
+export interface ExplainerSourceBacklinks {
+    SOURCE_BACKLINK_CONTRACT_VERSION: typeof SOURCE_BACKLINK_CONTRACT_VERSION;
+    parseCanonicalGithubBlobUrl: (value: string) => CanonicalSourceBacklink;
+}
+export declare function loadExplainerSourceBacklinks(): Promise<ExplainerSourceBacklinks>;
+export {};
+//# sourceMappingURL=explainer-source-backlinks.d.ts.map

package/dist/commands/project/archive/explainer-source-backlinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainer-source-backlinks.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/explainer-source-backlinks.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,gCAAgC,sCAAsC,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,gCAAgC,EAAE,OAAO,gCAAgC,CAAC;IAC1E,2BAA2B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,uBAAuB,CAAC;CACzE;AAID,wBAAgB,4BAA4B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAGhF"}

package/dist/commands/project/archive/explainer-source-backlinks.js

@@ -0,0 +1,27 @@
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { CliError } from '../../../errors/cli-error.js';
+import { resolveAssetsRoot } from '../../../fs/assets.js';
+const SOURCE_BACKLINK_CONTRACT_VERSION = 'explainer-kit.source-backlinks/v1';
+let cachedBacklinks;
+export function loadExplainerSourceBacklinks() {
+    cachedBacklinks ??= loadGeneratedBacklinks();
+    return cachedBacklinks;
+}
+async function loadGeneratedBacklinks() {
+    const assetsRoot = await resolveAssetsRoot();
+    const modulePath = join(assetsRoot, 'skills', 'explainer-kit', 'scripts', 'lib', 'source-backlinks.mjs');
+    let loaded;
+    try {
+        loaded = (await import(pathToFileURL(modulePath).href));
+    }
+    catch (error) {
+        throw new CliError(`Bundled explainer source backlink contract could not be loaded: ${error instanceof Error ? error.message : String(error)}`, 2);
+    }
+    if (loaded.SOURCE_BACKLINK_CONTRACT_VERSION !==
+        SOURCE_BACKLINK_CONTRACT_VERSION ||
+        typeof loaded.parseCanonicalGithubBlobUrl !== 'function') {
+        throw new CliError(`Bundled assets must provide ${SOURCE_BACKLINK_CONTRACT_VERSION}.`, 2);
+    }
+    return loaded;
+}

package/dist/commands/project/archive/push-runner.d.ts

@@ -1,6 +1,6 @@
 import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
 import { type OatConfig, type OatLocalConfig } from '../../../config/oat-config.js';
-import { resolveArchiveProjectTarget, resolvePrimaryRepoRoot, type ArchiveProjectOnCompletionOptions, type ArchiveProjectOnCompletionResult } from './archive-utils.js';
+import { resolveArchiveProjectTarget, resolvePrimaryRepoRoot, verifySelectedProjectRecapForArchive, type ArchiveProjectOnCompletionOptions, type ArchiveProjectOnCompletionResult } from './archive-utils.js';
 export interface ArchivePushOptions {
     dryRun?: boolean;
     projectRecapRun?: string;
@@ -13,6 +13,7 @@ export interface ProjectArchivePushCommandDependencies {
     resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
     resolvePrimaryRepoRoot: typeof resolvePrimaryRepoRoot;
     resolveArchiveProjectTarget: typeof resolveArchiveProjectTarget;
+    verifySelectedProjectRecapForArchive: typeof verifySelectedProjectRecapForArchive;
     archiveProjectOnCompletion: (options: ArchiveProjectOnCompletionOptions) => Promise<ArchiveProjectOnCompletionResult>;
     processEnv: NodeJS.ProcessEnv;
     timestamp: () => string;

package/dist/commands/project/archive/push-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push-runner.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/push-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAKL,2BAA2B,EAC3B,sBAAsB,EAEtB,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EAEtC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qCAAqC;IACpD,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,2BAA2B,EAAE,OAAO,2BAA2B,CAAC;IAChE,0BAA0B,EAAE,CAC1B,OAAO,EAAE,iCAAiC,KACvC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,MAAM,CAAC;CACzB;AAmBD,wBAAgB,4CAA4C,IAAI,qCAAqC,CAapG;AAkJD,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,qCAAqC,EACnD,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAoEf"}
+{"version":3,"file":"push-runner.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/push-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAKL,2BAA2B,EAC3B,sBAAsB,EACtB,oCAAoC,EAEpC,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EAEtC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qCAAqC;IACpD,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,2BAA2B,EAAE,OAAO,2BAA2B,CAAC;IAChE,oCAAoC,EAAE,OAAO,oCAAoC,CAAC;IAClF,0BAA0B,EAAE,CAC1B,OAAO,EAAE,iCAAiC,KACvC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,MAAM,CAAC;CACzB;AAmBD,wBAAgB,4CAA4C,IAAI,qCAAqC,CAcpG;AAkJD,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,qCAAqC,EACnD,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA0Ef"}

package/dist/commands/project/archive/push-runner.js

@@ -4,7 +4,7 @@ import { resolveProjectsRoot } from '../../shared/oat-paths.js';
 import { readOatConfig, readOatLocalConfig, } from '../../../config/oat-config.js';
 import { CliError } from '../../../errors/cli-error.js';
 import { resolveProjectRoot } from '../../../fs/paths.js';
-import { archiveProjectOnCompletion, assertDurableArchiveProjectTarget, buildArchiveSnapshotName, buildProjectArchiveS3Uri, resolveArchiveProjectTarget, resolvePrimaryRepoRoot, } from './archive-utils.js';
+import { archiveProjectOnCompletion, assertDurableArchiveProjectTarget, buildArchiveSnapshotName, buildProjectArchiveS3Uri, resolveArchiveProjectTarget, resolvePrimaryRepoRoot, verifySelectedProjectRecapForArchive, } from './archive-utils.js';
 export function defaultProjectArchivePushCommandDependencies() {
     return {
         buildCommandContext,
@@ -14,6 +14,7 @@ export function defaultProjectArchivePushCommandDependencies() {
         resolveProjectsRoot,
         resolvePrimaryRepoRoot,
         resolveArchiveProjectTarget,
+        verifySelectedProjectRecapForArchive,
         archiveProjectOnCompletion,
         processEnv: process.env,
         timestamp: () => new Date().toISOString(),
@@ -121,6 +122,9 @@ export async function runArchivePushCommand(dependencies, projectPathArg, option
             timestamp: dependencies.timestamp,
         });
         assertDurableArchiveProjectTarget(archiveTarget);
+        if (options.projectRecapRun?.trim()) {
+            await dependencies.verifySelectedProjectRecapForArchive(target.projectPath, options.projectRecapRun.trim());
+        }
         const dryRun = options.dryRun === true || context.dryRun;
         if (dryRun) {
             const report = await buildDryRunReport(dependencies, repoRoot, config, target, archiveTarget);

package/dist/release/public-package-contract.d.ts

@@ -4,14 +4,20 @@ export interface PublicPackageContract {
     role: 'cli' | 'docs-library' | 'support-library';
     requiredMetadataFields: string[];
     requiredPaths: string[];
+    requiredPackedTextFiles: PackedTextFileRequirement[];
     forbiddenPathPatterns: string[];
     versionPolicyAdditionalRoots: string[];
     versionPolicyIgnorePatterns: string[];
 }
+export interface PackedTextFileRequirement {
+    path: string;
+    requiredContents: string[];
+}
 export declare function getPublicPackageContracts(): PublicPackageContract[];
 export declare function findMissingMetadataFields(packageJson: Record<string, unknown>, contract: PublicPackageContract): string[];
 export declare function findMissingPackedPaths(packedPaths: readonly string[], contract: PublicPackageContract): string[];
 export declare function findForbiddenPackedPaths(packedPaths: readonly string[], contract: PublicPackageContract): string[];
+export declare function findMissingPackedTextContents(packedTextFiles: Readonly<Record<string, string>>, contract: PublicPackageContract): string[];
 export declare function findWorkspaceProtocolDependencySpecs(packageJson: Record<string, unknown>): string[];
 export declare function findNonPublicWorkspaceDependencySpecs(packageJson: Record<string, unknown>, publicPackageNames: readonly string[], workspacePackageNames: readonly string[]): string[];
 //# sourceMappingURL=public-package-contract.d.ts.map

package/dist/release/public-package-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-package-contract.d.ts","sourceRoot":"","sources":["../../src/release/public-package-contract.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACjD,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,2BAA2B,EAAE,MAAM,EAAE,CAAC;CACvC;AAmHD,wBAAgB,yBAAyB,IAAI,qBAAqB,EAAE,CASnE;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAMV;AAED,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,EAAE,CAmBV;AAED,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,qBAAqB,EAAE,SAAS,MAAM,EAAE,GACvC,MAAM,EAAE,CA0BV"}
+{"version":3,"file":"public-package-contract.d.ts","sourceRoot":"","sources":["../../src/release/public-package-contract.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACjD,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uBAAuB,EAAE,yBAAyB,EAAE,CAAC;IACrD,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,2BAA2B,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2KD,wBAAgB,yBAAyB,IAAI,qBAAqB,EAAE,CAenE;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAIV;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAMV;AAED,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACjD,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,EAAE,CAoBV;AAED,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,EAAE,CAmBV;AAED,wBAAgB,qCAAqC,CACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,qBAAqB,EAAE,SAAS,MAAM,EAAE,GACvC,MAAM,EAAE,CA0BV"}

package/dist/release/public-package-contract.js

@@ -18,6 +18,23 @@ const PACKED_DEPENDENCY_FIELDS = [
     'optionalDependencies',
     'peerDependencies',
 ];
+const MIT_LICENSE_BODY = `Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.`;
 const PUBLIC_PACKAGE_CONTRACTS = [
     {
         workspaceDir: 'packages/cli',
@@ -32,8 +49,42 @@ const PUBLIC_PACKAGE_CONTRACTS = [
             'assets/templates/repo-agents.md',
             'assets/templates/pjm-agents.md',
             'assets/templates/reference-agents.md',
+            'assets/skills/explainer-kit/scripts/lib/package-coverage.mjs',
+            'assets/skills/explainer-kit/scripts/lib/source-backlinks.mjs',
+            'assets/NOTICES.md',
             'README.md',
         ],
+        requiredPackedTextFiles: [
+            {
+                path: 'assets/NOTICES.md',
+                requiredContents: [
+                    '**Source:** https://github.com/obra/superpowers',
+                    '**Version referenced:** 5.0.7',
+                    `Copyright (c) 2025 Jesse Vincent\n\n${MIT_LICENSE_BODY}`,
+                    '**Source:** https://github.com/shadcn/improve/tree/main/skills/improve',
+                    '**Version referenced:** `main` (retrieved 2026-07-12)',
+                    `Copyright (c) 2026 shadcn\n\n${MIT_LICENSE_BODY}`,
+                    '**Source:** https://github.com/nicobailon/visual-explainer',
+                    '**Version referenced:** 0.8.1',
+                    `Copyright (c) 2025 Nico Bailon\n\n${MIT_LICENSE_BODY}`,
+                ],
+            },
+            {
+                path: 'assets/skills/explainer-kit/scripts/lib/package-coverage.mjs',
+                requiredContents: [
+                    'explainer-kit.package-coverage/v2',
+                    'export function requiredImmutablePackagePaths',
+                    'export async function validateImmutablePackageEvidence',
+                ],
+            },
+            {
+                path: 'assets/skills/explainer-kit/scripts/lib/source-backlinks.mjs',
+                requiredContents: [
+                    'explainer-kit.source-backlinks/v1',
+                    'export function parseCanonicalGithubBlobUrl',
+                ],
+            },
+        ],
         forbiddenPathPatterns: [...COMMON_FORBIDDEN_PATH_PATTERNS],
         versionPolicyAdditionalRoots: [
             '.agents/skills',
@@ -50,6 +101,7 @@ const PUBLIC_PACKAGE_CONTRACTS = [
         role: 'support-library',
         requiredMetadataFields: [...COMMON_METADATA_FIELDS, 'exports', 'types'],
         requiredPaths: ['dist/index.js', 'dist/index.d.ts', 'README.md'],
+        requiredPackedTextFiles: [],
         forbiddenPathPatterns: [...COMMON_FORBIDDEN_PATH_PATTERNS],
         versionPolicyAdditionalRoots: [],
         versionPolicyIgnorePatterns: [],
@@ -60,6 +112,7 @@ const PUBLIC_PACKAGE_CONTRACTS = [
         role: 'docs-library',
         requiredMetadataFields: [...COMMON_METADATA_FIELDS, 'exports', 'types'],
         requiredPaths: ['dist/index.js', 'dist/index.d.ts', 'README.md'],
+        requiredPackedTextFiles: [],
         forbiddenPathPatterns: [...COMMON_FORBIDDEN_PATH_PATTERNS],
         versionPolicyAdditionalRoots: [],
         versionPolicyIgnorePatterns: [],
@@ -70,6 +123,7 @@ const PUBLIC_PACKAGE_CONTRACTS = [
         role: 'docs-library',
         requiredMetadataFields: [...COMMON_METADATA_FIELDS, 'exports', 'types'],
         requiredPaths: ['dist/index.js', 'dist/index.d.ts', 'README.md'],
+        requiredPackedTextFiles: [],
         forbiddenPathPatterns: [...COMMON_FORBIDDEN_PATH_PATTERNS],
         versionPolicyAdditionalRoots: [],
         versionPolicyIgnorePatterns: [],
@@ -80,6 +134,7 @@ const PUBLIC_PACKAGE_CONTRACTS = [
         role: 'docs-library',
         requiredMetadataFields: [...COMMON_METADATA_FIELDS, 'exports', 'types'],
         requiredPaths: ['dist/index.js', 'dist/index.d.ts', 'README.md'],
+        requiredPackedTextFiles: [],
         forbiddenPathPatterns: [...COMMON_FORBIDDEN_PATH_PATTERNS],
         versionPolicyAdditionalRoots: [],
         versionPolicyIgnorePatterns: [],
@@ -101,6 +156,10 @@ export function getPublicPackageContracts() {
         ...contract,
         requiredMetadataFields: [...contract.requiredMetadataFields],
         requiredPaths: [...contract.requiredPaths],
+        requiredPackedTextFiles: contract.requiredPackedTextFiles.map((requirement) => ({
+            ...requirement,
+            requiredContents: [...requirement.requiredContents],
+        })),
         forbiddenPathPatterns: [...contract.forbiddenPathPatterns],
         versionPolicyAdditionalRoots: [...contract.versionPolicyAdditionalRoots],
         versionPolicyIgnorePatterns: [...contract.versionPolicyIgnorePatterns],
@@ -115,6 +174,22 @@ export function findMissingPackedPaths(packedPaths, contract) {
 export function findForbiddenPackedPaths(packedPaths, contract) {
     return packedPaths.filter((packedPath) => contract.forbiddenPathPatterns.some((pattern) => matchesGlob(packedPath, pattern)));
 }
+export function findMissingPackedTextContents(packedTextFiles, contract) {
+    const missing = [];
+    for (const requirement of contract.requiredPackedTextFiles) {
+        const contents = packedTextFiles[requirement.path];
+        if (contents === undefined) {
+            missing.push(`${requirement.path} (missing file)`);
+            continue;
+        }
+        for (const requiredContent of requirement.requiredContents) {
+            if (!contents.includes(requiredContent)) {
+                missing.push(`${requirement.path} (missing ${requiredContent.split('\n')[0]})`);
+            }
+        }
+    }
+    return missing;
+}
 export function findWorkspaceProtocolDependencySpecs(packageJson) {
     const workspaceSpecs = [];
     for (const dependencyField of PACKED_DEPENDENCY_FIELDS) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.2.26",
+  "version": "0.2.27",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.2.26"
+    "@open-agent-toolkit/control-plane": "0.2.27"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",