@lesliechan721/aw-plugin-core 0.1.0-beta.3 → 0.1.0-beta.5

package/dist/plugin-authoring-capabilities.d.ts

@@ -0,0 +1,21 @@
+export declare const PLUGIN_AUTHORING_CAPABILITY_SURFACES: readonly ["manifest", "build-config", "extensions", "slash-commands", "mcp-apps", "config", "lifecycle", "artifacts"];
+export type PluginAuthoringCapabilitySurfaceName = (typeof PLUGIN_AUTHORING_CAPABILITY_SURFACES)[number];
+export type PluginAuthoringAcceptedValue = string | number | boolean;
+export interface PluginAuthoringCapabilityEntry {
+    field: string;
+    type: string;
+    required: boolean | string;
+    acceptedValues?: readonly PluginAuthoringAcceptedValue[] | string;
+}
+export interface PluginAuthoringCapabilitySurface {
+    surface: PluginAuthoringCapabilitySurfaceName;
+    entries: readonly PluginAuthoringCapabilityEntry[];
+}
+export interface PluginAuthoringCapabilityRegistry {
+    schemaVersion: 1;
+    surfaces: Readonly<Record<PluginAuthoringCapabilitySurfaceName, PluginAuthoringCapabilitySurface>>;
+}
+export declare function getPluginAuthoringCapabilities(): PluginAuthoringCapabilityRegistry;
+export declare function getPluginAuthoringCapabilitySurface(surface: PluginAuthoringCapabilitySurfaceName): PluginAuthoringCapabilitySurface;
+export declare function getPluginAuthoringAcceptedValues(surface: PluginAuthoringCapabilitySurfaceName, field: string): readonly PluginAuthoringAcceptedValue[];
+export declare function getPluginCoreVersion(): string;

package/dist/plugin-authoring-capabilities.js

@@ -0,0 +1,176 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PLUGIN_LIFECYCLE_EVENTS, PLUGIN_LIFECYCLE_OS_SELECTORS, PLUGIN_SCRIPT_RUNNERS, PLUGIN_SCRIPT_TIMEOUT_MAX_MS, PLUGIN_SCRIPT_TIMEOUT_MIN_MS, } from './plugin-script-contract.js';
+import { PUBLIC_HOOK_EVENTS } from './hooks-contract.js';
+export const PLUGIN_AUTHORING_CAPABILITY_SURFACES = [
+    'manifest',
+    'build-config',
+    'extensions',
+    'slash-commands',
+    'mcp-apps',
+    'config',
+    'lifecycle',
+    'artifacts',
+];
+const registry = {
+    schemaVersion: 1,
+    surfaces: {
+        manifest: {
+            surface: 'manifest',
+            entries: [
+                { field: 'schemaVersion', type: 'literal 1', required: false, acceptedValues: [1] },
+                { field: 'name', type: 'kebab-case string', required: true },
+                { field: 'version', type: 'stable strict SemVer', required: true },
+                { field: 'description', type: 'non-empty string', required: true },
+                { field: 'compatibility.aw.minVersion', type: 'strict SemVer', required: true },
+                { field: 'dependencies', type: 'unique plugin-name[]', required: false },
+                { field: 'skills', type: './ plugin-relative path', required: false },
+                { field: 'slashCommands', type: './ plugin-relative path', required: false },
+                { field: 'mcpServers', type: './ plugin-relative path', required: false },
+                { field: 'apps', type: './ plugin-relative path', required: false },
+                { field: 'distributions.agentSkills', type: '{skills?}', required: false },
+                { field: 'distributions.agentSkills.skills', type: './ plugin-relative path', required: false },
+                { field: 'marketplace.category', type: 'non-empty string', required: true },
+                { field: 'marketplace.tags', type: 'string[]', required: false },
+                { field: 'marketplace.strict', type: 'boolean', required: true },
+                { field: 'marketplace.policy.installation', type: 'enum', required: true, acceptedValues: ['AVAILABLE', 'NOT_AVAILABLE', 'INSTALLED_BY_DEFAULT'] },
+                { field: 'marketplace.policy.authentication', type: 'enum', required: true, acceptedValues: ['ON_INSTALL', 'ON_USE'] },
+                { field: 'marketplace.policy.products', type: 'unique enum[]', required: false, acceptedValues: ['CODEX', 'CLAUDE'] },
+                { field: 'interface.displayName', type: 'non-empty string', required: false },
+                { field: 'interface.shortDescription', type: 'non-empty string', required: false },
+                { field: 'interface.capabilities', type: 'string[]', required: false },
+            ],
+        },
+        'build-config': {
+            surface: 'build-config',
+            entries: [
+                { field: 'buildConfig.cacheable', type: 'literal true', required: false, acceptedValues: [true] },
+                { field: 'buildConfig.templates', type: '{vars,include}', required: false },
+                { field: 'buildConfig.templates.vars.<key>', type: '{claude:string|boolean,codex:string|boolean}', required: 'with buildConfig.templates' },
+                { field: 'buildConfig.templates.include', type: 'string[]', required: 'with buildConfig.templates' },
+                { field: 'buildConfig.fileRules', type: 'platform include/exclude object', required: false },
+                { field: 'buildConfig.fileRules.<platform>', type: '{include,exclude}', required: false, acceptedValues: ['claude', 'codex'] },
+                { field: 'buildConfig.manifestOverrides.claude', type: 'object', required: false, acceptedValues: ['outputStyles', 'lspServers', 'userConfig', 'channels'] },
+                { field: 'buildConfig.runtimeExports', type: '{name,source}[]', required: false },
+                { field: 'buildConfig.buildImports', type: '{plugin,export,env}[]', required: false },
+                { field: 'buildConfig.skillRuntimeFiles', type: '{skill,target,platforms?,distributions?,source|import}[]', required: false },
+                { field: 'buildConfig.skillRuntimeFiles[].platforms', type: 'unique enum[]', required: false, acceptedValues: ['codex', 'claude'] },
+                { field: 'buildConfig.skillRuntimeFiles[].distributions', type: 'unique enum[]', required: false, acceptedValues: ['agent-skills'] },
+                { field: 'buildConfig.generatedSkillRuntimeFiles', type: '{skill,target,distributions?}[]', required: false },
+                { field: 'buildConfig.generatedSkillRuntimeFiles[].distributions', type: 'unique enum[]', required: false, acceptedValues: ['agent-skills'] },
+            ],
+        },
+        extensions: {
+            surface: 'extensions',
+            entries: [
+                { field: 'extensions.instructions', type: '{name,title,content,paths?,agentOverrides?}[]', required: false },
+                { field: 'extensions.permissions', type: '{name,allow?,ask?,deny?,agentOverrides?}[]', required: false },
+                { field: 'extensions.hooks', type: '{event,matcher?,command,agentOverrides?}[]', required: false },
+                { field: 'extensions.hooks[].event', type: 'enum', required: true, acceptedValues: PUBLIC_HOOK_EVENTS },
+                { field: 'extensions.nativeHooks.claude', type: 'native hook[]', required: false },
+                { field: 'extensions.nativeHooks.codex', type: 'native hook[]', required: false },
+                { field: 'extensions.agents', type: '{name,description,prompt,tools?,agentOverrides?}[]', required: false },
+            ],
+        },
+        'slash-commands': {
+            surface: 'slash-commands',
+            entries: [
+                { field: 'description', type: 'string', required: true },
+                { field: 'claude', type: 'frontmatter object', required: false, acceptedValues: ['description', 'allowed-tools', 'model', 'argument-hint', 'shell'] },
+                { field: 'claude.shell', type: 'enum', required: false, acceptedValues: ['bash', 'powershell'] },
+                { field: 'codex.description', type: 'string', required: false },
+                { field: 'codex.interface', type: 'display metadata object', required: false, acceptedValues: ['display_name', 'short_description', 'icon_small', 'icon_large', 'brand_color', 'default_prompt'] },
+                { field: 'codex.generated.policy.allow_implicit_invocation', type: 'literal false', required: true, acceptedValues: [false] },
+            ],
+        },
+        'mcp-apps': {
+            surface: 'mcp-apps',
+            entries: [
+                { field: 'mcpServers.<key>.command', type: 'string', required: 'stdio transport' },
+                { field: 'mcpServers.<key>.args', type: 'string[]', required: false },
+                { field: 'mcpServers.<key>.env', type: 'string map', required: false },
+                { field: 'mcpServers.<key>.headers', type: 'string map', required: false },
+                { field: 'mcpServers.<key>.url', type: 'URL string', required: 'HTTP transport' },
+                { field: 'apps.<key>.id', type: 'non-empty string', required: true },
+            ],
+        },
+        config: {
+            surface: 'config',
+            entries: [
+                { field: 'config.schema', type: 'field map', required: 'with config' },
+                { field: 'config.schema.<key>.type', type: 'enum', required: true, acceptedValues: ['string', 'number', 'boolean', 'enum', 'file', 'directory'] },
+                { field: 'config.schema.<key>.title', type: 'string', required: false },
+                { field: 'config.schema.<key>.description', type: 'string', required: false },
+                { field: 'config.schema.<key>.default', type: 'string|number|boolean', required: false },
+                { field: 'config.schema.<key>.required', type: 'boolean', required: false },
+                { field: 'config.schema.<key>.sensitive', type: 'boolean', required: false },
+                { field: 'config.schema.<key>.values', type: 'string[]', required: false },
+                { field: 'config.schema.<key>.min', type: 'number', required: false },
+                { field: 'config.schema.<key>.max', type: 'number', required: false },
+                { field: 'config.presentation', type: 'groups/fields/presets object', required: false },
+            ],
+        },
+        lifecycle: {
+            surface: 'lifecycle',
+            entries: [
+                { field: 'scripts.lifecycle', type: 'event selector object', required: false, acceptedValues: PLUGIN_LIFECYCLE_EVENTS },
+                { field: 'scripts.lifecycle.<event>', type: 'string | OS selector object', required: false, acceptedValues: PLUGIN_LIFECYCLE_OS_SELECTORS },
+                { field: 'scripts.lifecycle.<event>.<selector>.runner', type: 'enum', required: true, acceptedValues: PLUGIN_SCRIPT_RUNNERS },
+                { field: 'scripts.lifecycle.<event>.<selector>.path', type: './ plugin-relative path', required: true },
+                { field: 'scripts.lifecycle.<event>.<selector>.args', type: 'string[]', required: false },
+                { field: 'scripts.timeoutMs', type: 'integer', required: false, acceptedValues: `${PLUGIN_SCRIPT_TIMEOUT_MIN_MS}..${PLUGIN_SCRIPT_TIMEOUT_MAX_MS}` },
+                { field: 'scripts.helpers.config', type: './ Node path', required: false },
+                { field: 'scripts.node.packageRoot', type: './ package directory path', required: false },
+                { field: 'scripts.node.build', type: '{runner,path,args?}', required: false },
+                { field: 'scripts.node.build.runner', type: 'literal node', required: true, acceptedValues: ['node'] },
+                { field: 'scripts.tests.node', type: './ Node path[]', required: false },
+            ],
+        },
+        artifacts: {
+            surface: 'artifacts',
+            entries: [
+                { field: 'scripts.artifacts.render', type: '{runner,path,args?}', required: 'with artifacts.targets' },
+                { field: 'scripts.artifacts.render.runner', type: 'literal node', required: true, acceptedValues: ['node'] },
+                { field: 'artifacts.targets', type: 'artifact target[]', required: false },
+                { field: 'artifacts.targets[].id', type: 'stable identifier', required: true },
+                { field: 'artifacts.targets[].platform', type: 'enum', required: 'for native targets', acceptedValues: ['codex', 'claude'] },
+                { field: 'artifacts.targets[].distribution', type: 'enum', required: 'for portable targets', acceptedValues: ['agent-skills'] },
+                { field: 'artifacts.targets[].target', type: 'enum', required: true, acceptedValues: ['codex.developerInstructionsBlock', 'codex.agentRole', 'codex.skill', 'claude.skill', 'agent-skills.skill'] },
+                { field: 'artifacts.targets[].kind', type: 'enum', required: false, acceptedValues: ['instruction', 'codexRole', 'skill'] },
+                { field: 'artifacts.targets[].projectManagedKind', type: 'enum', required: false, acceptedValues: ['skill', 'mcpServer', 'instruction', 'permission', 'hook', 'agent'] },
+                { field: 'artifacts.targets[].scopes', type: 'unique enum[]', required: true, acceptedValues: ['user', 'project'] },
+                { field: 'artifacts.targets[].states', type: 'unique enum[]', required: true, acceptedValues: ['present', 'disabled'] },
+                { field: 'artifacts.targets[].refreshKeys', type: 'unique config key[]', required: true },
+                { field: 'artifacts.targets[].requiresCodexProjectConfig', type: 'boolean', required: false },
+                { field: 'artifacts.targets[].roleKey', type: 'stable role key', required: 'for codex.agentRole' },
+                { field: 'artifacts.targets[].skillKey', type: 'stable Skill key', required: 'for Skill targets' },
+                { field: 'artifacts.targets[].sourceDirs', type: './ plugin-relative path[]', required: false },
+                { field: 'artifacts.targets[].runtimeImports', type: '{name,plugin,export}[]', required: false },
+            ],
+        },
+    },
+};
+export function getPluginAuthoringCapabilities() {
+    return registry;
+}
+export function getPluginAuthoringCapabilitySurface(surface) {
+    return registry.surfaces[surface];
+}
+export function getPluginAuthoringAcceptedValues(surface, field) {
+    const entries = registry.surfaces[surface].entries;
+    const entry = entries.find((candidate) => candidate.field === field);
+    if (!entry || !Array.isArray(entry.acceptedValues)) {
+        throw new Error(`Plugin authoring capability ${surface}.${field} has no accepted values.`);
+    }
+    return entry.acceptedValues;
+}
+export function getPluginCoreVersion() {
+    const packageJsonPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+    if (typeof packageJson.version !== 'string') {
+        throw new Error('Cannot read @lesliechan721/aw-plugin-core package version.');
+    }
+    return packageJson.version;
+}
+//# sourceMappingURL=plugin-authoring-capabilities.js.map

package/dist/plugin-authoring-capabilities.js.map

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

package/dist/workspace.d.ts

@@ -1,14 +1,14 @@
 import { type PluginReleaseLedger } from './plugin-release.js';
 import type { ReservedImportRegistry } from './manifest-contract.js';
 import type { CatalogChannel, CatalogManifestV4, MarketplaceSourceMeta, PluginMeta } from './types.js';
-export declare const DEFAULT_WORKSPACE_CATALOG_VERSION = "0.1.0";
+export declare const DEFAULT_CATALOG_WORKSPACE_VERSION = "0.1.0";
 export declare const DEFAULT_CATALOG_OUTPUT_PATH: string;
 export declare const DEFAULT_PUBLISHED_CATALOG_OUTPUT_PATH: string;
 export declare const DEFAULT_PLUGIN_OUTPUT_PATH: string;
 export declare const CATALOG_MANIFEST_FILENAME = "catalog-manifest.json";
 export declare const GENERATED_OUTPUT_MARKER_FILENAME = ".aw-generated.json";
-export declare const WORKSPACE_MARKER_FILENAME = ".aw-workspace.json";
-export interface WorkspaceCatalogInitOptions {
+export declare const CATALOG_WORKSPACE_MARKER_FILENAME = ".aw-workspace.json";
+export interface CatalogWorkspaceInitOptions {
     workspaceRoot: string;
     ownerName?: string;
     ownerUrl?: string;
@@ -16,7 +16,7 @@ export interface WorkspaceCatalogInitOptions {
     catalogVersion?: string;
     force?: boolean;
 }
-export interface WorkspacePluginBuildAdapter {
+export interface CatalogWorkspacePluginBuildAdapter {
     build(options: {
         workspaceRoot: string;
         plugin: PluginMeta;
@@ -25,11 +25,24 @@ export interface WorkspacePluginBuildAdapter {
         outputRoot: string;
     }): Promise<void>;
 }
-export type WorkspaceCatalogBuildAdapter = WorkspacePluginBuildAdapter;
-export interface WorkspaceSourceOptions {
+export type CatalogWorkspaceBuildAdapter = CatalogWorkspacePluginBuildAdapter;
+export interface CatalogWorkspaceSourceOptions {
     reservedImports?: ReservedImportRegistry;
 }
-export declare function resolveWorkspaceOutputPath(options: {
+export type CatalogVersionBump = 'major' | 'minor' | 'patch';
+export interface CatalogVersionMutation {
+    version?: string;
+    bump?: CatalogVersionBump;
+}
+export interface CatalogWorkspace {
+    workspaceRoot: string;
+    markerPath: string;
+    workspaceIdentity: string;
+    metadataPath: string;
+    metadata: MarketplaceSourceMeta;
+    plugins: PluginMeta[];
+}
+export declare function resolveCatalogWorkspaceOutputPath(options: {
     workspaceRoot: string;
     outputPath: string;
     kind?: 'catalog' | 'plugin';
@@ -37,24 +50,22 @@ export declare function resolveWorkspaceOutputPath(options: {
     workspaceRoot: string;
     outputRoot: string;
 }>;
-export declare function initializePluginWorkspace(options: WorkspaceCatalogInitOptions): Promise<{
+export declare function initializeCatalogWorkspace(options: CatalogWorkspaceInitOptions): Promise<{
     workspaceRoot: string;
+    markerPath: string;
+    workspaceIdentity: string;
     metadataPath: string;
     metadata: MarketplaceSourceMeta;
 }>;
-export declare function readPluginWorkspace(workspaceRoot: string, options?: WorkspaceSourceOptions): Promise<{
-    workspaceRoot: string;
-    metadataPath: string;
-    metadata: MarketplaceSourceMeta;
-    plugins: PluginMeta[];
-}>;
-export declare function setWorkspaceCatalogVersion(workspaceRoot: string, version: string, options?: WorkspaceSourceOptions): Promise<MarketplaceSourceMeta>;
+export declare function readCatalogWorkspace(workspaceRoot: string, options?: CatalogWorkspaceSourceOptions): Promise<CatalogWorkspace>;
+export declare function resolveCatalogVersionMutation(currentVersion: string, mutation: CatalogVersionMutation): string;
+export declare function mutateCatalogWorkspaceVersion(workspaceRoot: string, mutation: CatalogVersionMutation, options?: CatalogWorkspaceSourceOptions): Promise<MarketplaceSourceMeta>;
 export declare function deriveCatalogChannel(version: string): CatalogChannel;
-export declare function buildWorkspaceCatalog(options: {
+export declare function buildCatalogWorkspace(options: {
     workspaceRoot: string;
     outputPath?: string;
     force?: boolean;
-    adapter: WorkspaceCatalogBuildAdapter;
+    adapter: CatalogWorkspaceBuildAdapter;
     reservedImports?: ReservedImportRegistry;
 }): Promise<{
     outputRoot: string;
@@ -68,12 +79,12 @@ export declare function validatePublishedCatalogSnapshot(snapshotDirectory: stri
     ledger: PluginReleaseLedger;
     snapshotDigest: string;
 }>;
-export declare function preparePublishedWorkspaceCatalog(options: {
+export declare function preparePublishedCatalogWorkspace(options: {
     workspaceRoot: string;
     sourceHead: string;
     outputPath?: string;
     previousSnapshotRoot?: string;
-    adapter: WorkspaceCatalogBuildAdapter;
+    adapter: CatalogWorkspaceBuildAdapter;
     reservedImports?: ReservedImportRegistry;
 }): Promise<{
     outputRoot: string;
@@ -84,12 +95,12 @@ export declare function preparePublishedWorkspaceCatalog(options: {
     contentDigest: string;
     planId: string;
 }>;
-export declare function buildWorkspacePlugin(options: {
+export declare function buildCatalogWorkspacePlugin(options: {
     workspaceRoot: string;
     pluginDirectory: string;
     outputPath?: string;
     force?: boolean;
-    adapter: WorkspacePluginBuildAdapter;
+    adapter: CatalogWorkspacePluginBuildAdapter;
     reservedImports?: ReservedImportRegistry;
 }): Promise<{
     outputRoot: string;