@lesliechan721/aw 0.1.0-beta.6 → 0.1.0-beta.60

package/dist/src/commands/aw-capabilities.js

@@ -0,0 +1,266 @@
+import { realpath } from 'node:fs/promises';
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { readCatalogWorkspace, } from '@lesliechan721/aw-plugin-core';
+import { checkAwCapabilitySupport, createAwPluginRequirementsReceipt, computeAwCapabilitySetDigest, getPluginCoreVersion, parseAwPluginRequirementsReceipt, resolvePluginRequirements, normalizeAwCapabilities, } from '@lesliechan721/aw-plugin-core/manifest';
+import fs from 'fs-extra';
+import { CLI_RESERVED_IMPORTS, readPluginManifest } from '../utils/manifest.js';
+import { resolveCatalogWorkspaceRoot, } from './catalog-workspace-resolution.js';
+export const IMPLEMENTED_AW_CAPABILITIES = [
+    'aw.plugin-manifest.v3',
+    'aw.plugin-skills.v1',
+    'aw.plugin-build-config.v1',
+    'aw.plugin-config.v2',
+    'aw.plugin-config.v3',
+    'aw.plugin-config.v4',
+    'aw.plugin-config-array.v1',
+    'aw.plugin-config-unique-by.v1',
+    'aw.plugin-config-value-ref.v1',
+    'aw.plugin-config-summary.v1',
+    'aw.plugin-pre-apply.v1',
+    'aw.dynamic-artifacts.v2',
+    'aw.managed-commands.v1',
+    'aw.native-tools.v2',
+    'aw.claude.sandbox-exclusions.v1',
+    'aw.portable-skills.v1',
+    'aw.runtime-imports.v1',
+    'aw.installed-runtime-config.v2',
+    'aw.skill-validation.v1',
+    'aw.skill-eval.v2',
+    'aw.plugin-authoring.v1',
+    'aw.catalog-authoring.v1',
+    'aw.catalog-source.v2',
+    'aw.catalog-dev-source.v1',
+    'aw.catalog-publication.v1',
+    'aw.review-preparation.v1',
+    'aw.review-inspection.v2',
+    'aw.catalog-snapshot.v7',
+    'aw.self-check.v1',
+];
+export class AwCapabilityUnsupportedError extends Error {
+    code = 'awCapabilityUnsupported';
+    plugin;
+    missingCapabilities;
+    availableCapabilities;
+    constructor(plugin, missingCapabilities) {
+        const missing = [...missingCapabilities];
+        super(`Plugin "${plugin}" requires unsupported AW capabilities: ${missing.join(', ')}.`);
+        this.name = 'AwCapabilityUnsupportedError';
+        this.plugin = plugin;
+        this.missingCapabilities = missing;
+        this.availableCapabilities = [...IMPLEMENTED_AW_CAPABILITIES].sort();
+    }
+}
+export function describeCurrentAw(awVersion) {
+    const capabilities = [...IMPLEMENTED_AW_CAPABILITIES].sort();
+    return {
+        schemaVersion: 1,
+        command: 'self:describe',
+        awVersion,
+        coreVersion: getPluginCoreVersion(),
+        capabilities,
+        capabilitySetDigest: computeAwCapabilitySetDigest(capabilities),
+    };
+}
+async function startDirectory(from) {
+    const resolved = path.resolve(from);
+    const stats = await fs.stat(resolved);
+    return stats.isDirectory() ? resolved : path.dirname(resolved);
+}
+async function candidateExists(filePath) {
+    try {
+        const stats = await fs.lstat(filePath);
+        if (!stats.isFile())
+            throw new Error(`Invalid AW plugin requirements candidate: expected a regular file at ${filePath}.`);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function requirementsFromManifest(pluginRoot) {
+    let plugin;
+    try {
+        plugin = await readPluginManifest(pluginRoot, { mode: 'bundle' });
+    }
+    catch (bundleError) {
+        try {
+            plugin = await readPluginManifest(pluginRoot, { mode: 'source' });
+        }
+        catch {
+            throw bundleError;
+        }
+    }
+    const resolution = await resolvePluginRequirements({
+        pluginRoot,
+        manifest: plugin.manifest,
+        implementedCapabilities: IMPLEMENTED_AW_CAPABILITIES,
+    });
+    return {
+        source: { kind: 'manifest', path: plugin.manifestPath },
+        plugin: { name: plugin.manifest.name, version: plugin.manifest.version },
+        requiredCapabilities: resolution.effective,
+        capabilitySetDigest: resolution.capabilitySetDigest,
+        resolution,
+    };
+}
+export async function discoverAwPluginRequirements(from) {
+    let current = await startDirectory(from);
+    while (true) {
+        const receiptPath = path.join(current, 'aw-plugin-requirements.json');
+        if (await candidateExists(receiptPath)) {
+            const receipt = parseAwPluginRequirementsReceipt(await fs.readJson(receiptPath));
+            return {
+                source: { kind: 'receipt', path: receiptPath },
+                plugin: receipt.plugin,
+                requiredCapabilities: receipt.requiredCapabilities,
+                capabilitySetDigest: receipt.digest,
+            };
+        }
+        const manifestPath = path.join(current, '.agents-plugin', 'plugin.json');
+        if (await candidateExists(manifestPath))
+            return requirementsFromManifest(current);
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    throw new Error('No aw-plugin-requirements.json or .agents-plugin/plugin.json was found.');
+}
+export async function checkCurrentAw(options) {
+    try {
+        const discovered = await discoverAwPluginRequirements(options.from);
+        const support = checkAwCapabilitySupport(discovered.requiredCapabilities, IMPLEMENTED_AW_CAPABILITIES);
+        const observations = discovered.resolution?.observations ?? [];
+        return {
+            schemaVersion: 1,
+            command: 'self:check',
+            ok: support.supported,
+            awVersion: options.awVersion,
+            coreVersion: getPluginCoreVersion(),
+            source: discovered.source,
+            plugin: discovered.plugin,
+            requiredCapabilities: discovered.requiredCapabilities,
+            capabilitySetDigest: discovered.capabilitySetDigest,
+            missingCapabilities: support.missing,
+            observations,
+        };
+    }
+    catch (error) {
+        return {
+            schemaVersion: 1,
+            command: 'self:check',
+            ok: false,
+            awVersion: options.awVersion,
+            coreVersion: getPluginCoreVersion(),
+            source: null,
+            plugin: null,
+            requiredCapabilities: [],
+            capabilitySetDigest: null,
+            missingCapabilities: [],
+            observations: [],
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+async function resolveCanonicalPluginRequirementsTarget(options) {
+    const requestedPluginRoot = path.resolve(options.cwd, options.pluginDirectory);
+    const workspaceResolution = await resolveCatalogWorkspaceRoot({
+        cwd: requestedPluginRoot,
+        ...(options.workspaceRoot === undefined
+            ? {}
+            : { explicitRoot: path.resolve(options.cwd, options.workspaceRoot) }),
+        mode: 'existing',
+    });
+    const workspace = await readCatalogWorkspace(workspaceResolution.workspaceRoot, {
+        reservedImports: CLI_RESERVED_IMPORTS,
+    });
+    const stat = await fs.lstat(requestedPluginRoot).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!stat?.isDirectory() || stat.isSymbolicLink()) {
+        throw new Error(`Plugin directory must be a regular non-symbolic-link directory: ${requestedPluginRoot}`);
+    }
+    const canonicalPluginRoot = await realpath(requestedPluginRoot);
+    const plugin = workspace.plugins.find((entry) => entry.manifest.name === path.basename(canonicalPluginRoot));
+    const expectedPluginRoot = plugin
+        ? await realpath(path.join(workspace.workspaceRoot, 'plugins', plugin.manifest.name))
+        : null;
+    if (!plugin
+        || expectedPluginRoot !== canonicalPluginRoot) {
+        throw new Error(`Plugin directory is not a canonical plugin in this Catalog Workspace: ${requestedPluginRoot}`);
+    }
+    return {
+        plugin: { ...plugin, rootDir: canonicalPluginRoot },
+        workspaceRoot: await realpath(workspaceResolution.workspaceRoot),
+        workspaceRootResolvedFrom: workspaceResolution.workspaceRootResolvedFrom,
+    };
+}
+async function writeJsonAtomic(filePath, value) {
+    const temporaryPath = path.join(path.dirname(filePath), `.${path.basename(filePath)}.${crypto.randomUUID()}.tmp`);
+    await fs.writeFile(temporaryPath, `${JSON.stringify(value, null, 2)}\n`, { flag: 'wx' });
+    try {
+        await fs.rename(temporaryPath, filePath);
+    }
+    catch (error) {
+        await fs.remove(temporaryPath);
+        throw error;
+    }
+}
+export async function inspectPluginRequirements(options) {
+    if (options.add !== undefined && options.remove !== undefined) {
+        throw new Error('Use exactly one of --add or --remove.');
+    }
+    const target = await resolveCanonicalPluginRequirementsTarget(options);
+    const pluginRoot = target.plugin.rootDir;
+    let plugin = target.plugin;
+    let mutation;
+    const action = options.add === undefined
+        ? (options.remove === undefined ? undefined : 'remove')
+        : 'add';
+    const capability = options.add ?? options.remove;
+    const initialResolution = await resolvePluginRequirements({
+        pluginRoot,
+        manifest: plugin.manifest,
+        implementedCapabilities: IMPLEMENTED_AW_CAPABILITIES,
+    });
+    if (action && capability) {
+        const normalizedCapability = normalizeAwCapabilities([capability], `--${action}`)[0];
+        const before = normalizeAwCapabilities(plugin.manifest.requires?.aw.capabilities ?? []);
+        const after = action === 'add'
+            ? normalizeAwCapabilities([...before, normalizedCapability])
+            : before.filter((value) => value !== normalizedCapability);
+        const changed = before.length !== after.length;
+        if (changed) {
+            const raw = await fs.readJson(plugin.manifestPath);
+            raw.requires = { aw: { capabilities: after } };
+            await writeJsonAtomic(plugin.manifestPath, raw);
+            plugin = await readPluginManifest(pluginRoot, { mode: 'source' });
+        }
+        mutation = { action, capability: normalizedCapability, changed };
+    }
+    const resolution = mutation?.changed
+        ? await resolvePluginRequirements({
+            pluginRoot,
+            manifest: plugin.manifest,
+            implementedCapabilities: IMPLEMENTED_AW_CAPABILITIES,
+        })
+        : initialResolution;
+    return {
+        command: 'plugin:requirements',
+        plugin: { name: plugin.manifest.name, version: plugin.manifest.version },
+        pluginDirectory: pluginRoot,
+        workspaceRoot: target.workspaceRoot,
+        workspaceRootResolvedFrom: target.workspaceRootResolvedFrom,
+        ...(mutation ? { mutation } : {}),
+        ...resolution,
+    };
+}
+export function createRequirementsReceipt(plugin, requiredCapabilities) {
+    return createAwPluginRequirementsReceipt(plugin, requiredCapabilities);
+}
+//# sourceMappingURL=aw-capabilities.js.map

package/dist/src/commands/aw-capabilities.js.map

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

package/dist/src/commands/catalog-dev-source.d.ts

@@ -0,0 +1,154 @@
+import type { CatalogGenerationActiveV1, CatalogGenerationCandidateEvidence, CatalogSourceImpact } from '../types.js';
+import { type CatalogGenerationStatusEntry } from '../utils/catalog-generation-service.js';
+import { type CatalogSourceCommandRuntime, type CatalogSourcePreflightInventory } from './catalog-source.js';
+type Issue = {
+    code: string;
+    message: string;
+    blocking: boolean;
+};
+export interface CatalogDevActivateReceipt {
+    receiptSchemaVersion: 2;
+    command: 'catalog:dev:activate';
+    ok: boolean;
+    state: 'completed' | 'partial' | 'failed';
+    workspaceIdentity: string | null;
+    snapshot: {
+        action: 'reused' | 'built';
+        digest: string | null;
+    };
+    source: {
+        id: string;
+        action: 'added' | 'updated' | 'reused';
+        primary: boolean;
+    };
+    active: {
+        ready: boolean;
+        snapshotDigest: string | null;
+    };
+    recovery: string[];
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export interface CatalogDevActivationReviewEvidence {
+    workspaceIdentity: string;
+    snapshotDigest: string;
+    sourceId: string;
+    initialConfigDigest: string;
+    finalConfigDigest: string;
+    sourceMutation?: {
+        proposedConfigDigest: string;
+        impactDigest: string;
+    };
+    primaryImpactDigest?: string;
+    candidate: CatalogGenerationCandidateEvidence;
+    active: CatalogGenerationActiveV1 | null;
+    generationImpactDigest: string;
+}
+export interface CatalogDevActivationPreflight {
+    review: CatalogDevActivationReviewEvidence;
+    impacts: CatalogSourceImpact[];
+    sourceImpact?: CatalogSourcePreflightInventory;
+}
+export interface CatalogDevStatusReceipt {
+    receiptSchemaVersion: 4;
+    command: 'catalog:dev:status';
+    ok: boolean;
+    ready: boolean;
+    workspaceIdentity: string | null;
+    snapshot: {
+        state: 'absent' | 'current' | 'stale' | 'invalid';
+        valid: boolean;
+        digest: string | null;
+    };
+    source: {
+        exists: boolean;
+        id: string | null;
+        pathMatches: boolean | null;
+        primary: boolean | null;
+    };
+    active: {
+        exists: boolean;
+        ready: boolean;
+        digestMatchesSnapshot: boolean;
+        snapshotDigest: string | null;
+        compatibility: CatalogGenerationStatusEntry['compatibility'];
+    };
+    issues: Issue[];
+}
+export interface CatalogDevDeactivateReceipt {
+    receiptSchemaVersion: 4;
+    command: 'catalog:dev:deactivate';
+    ok: boolean;
+    state: 'completed' | 'partial' | 'failed';
+    workspaceIdentity: string | null;
+    source: {
+        id: string | null;
+        action: 'removed' | 'absent' | 'retained';
+        previousPrimary: boolean;
+    };
+    replacementPrimarySourceId: string | null;
+    impact: CatalogSourcePreflightInventory | null;
+    recovery: string[];
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export type CatalogDevSourceRuntime = {
+    sourceRuntime?: CatalogSourceCommandRuntime;
+    beforeSync?: () => Promise<void> | void;
+    afterSync?: () => Promise<void> | void;
+};
+export declare function suggestedCatalogDevSourceId(workspaceRoot: string, workspaceIdentity?: string, occupiedSourceIds?: readonly string[]): string;
+export type CatalogDevCommand = 'activate' | 'status' | 'deactivate';
+export declare function createCatalogDevFailureReceipt(options: {
+    command: CatalogDevCommand;
+    cwd: string;
+    workspaceRoot?: string;
+    sourceId?: string;
+    code: string;
+    message: string;
+}): CatalogDevActivateReceipt | CatalogDevStatusReceipt | CatalogDevDeactivateReceipt;
+export declare function catalogDevSourceError(error: unknown, fallbackCode?: string): {
+    code: string;
+    message: string;
+};
+export declare function preflightCatalogDevSourceActivation(options: {
+    cwd: string;
+    workspaceRoot?: string;
+    sourceId?: string;
+    primary?: boolean;
+    forceBuild?: boolean;
+    cliVersion: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<CatalogDevActivationPreflight>;
+export declare function activateCatalogDevSource(options: {
+    cwd: string;
+    workspaceRoot?: string;
+    sourceId?: string;
+    primary?: boolean;
+    forceBuild?: boolean;
+    yes?: boolean;
+    cliVersion: string;
+    env: NodeJS.ProcessEnv;
+    expectedReview?: CatalogDevActivationReviewEvidence;
+    runtime?: CatalogDevSourceRuntime;
+}): Promise<CatalogDevActivateReceipt>;
+export declare function getCatalogDevSourceStatus(options: {
+    cwd: string;
+    workspaceRoot?: string;
+    cliVersion: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<CatalogDevStatusReceipt>;
+export declare function deactivateCatalogDevSource(options: {
+    cwd: string;
+    workspaceRoot?: string;
+    sourceId?: string;
+    replacementPrimary?: string;
+    yes?: boolean;
+    env: NodeJS.ProcessEnv;
+    runtime?: CatalogDevSourceRuntime;
+}): Promise<CatalogDevDeactivateReceipt>;
+export {};