@lesliechan721/aw 0.1.0-beta.7 → 0.1.0-beta.8

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

@@ -0,0 +1,259 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { readCatalogWorkspace, resolveCatalogWorkspaceRoot, } 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';
+export const IMPLEMENTED_AW_CAPABILITIES = [
+    'aw.plugin-manifest.v2',
+    'aw.plugin-skills.v1',
+    'aw.plugin-build-config.v1',
+    'aw.plugin-config.v1',
+    'aw.plugin-lifecycle.v1',
+    'aw.dynamic-artifacts.v2',
+    'aw.portable-skills.v1',
+    'aw.runtime-imports.v1',
+    'aw.skill-validation.v1',
+    'aw.plugin-authoring.v1',
+    'aw.catalog-authoring.v1',
+    'aw.catalog-context.v1',
+    'aw.catalog-source.v2',
+    'aw.catalog-dev-source.v1',
+    'aw.catalog-publication.v1',
+    'aw.catalog-snapshot.v5',
+    '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 ?? [];
+        const hasBlockingObservation = observations.some((observation) => observation.blocking);
+        return {
+            schemaVersion: 1,
+            command: 'self:check',
+            ok: support.supported && !hasBlockingObservation,
+            awVersion: options.awVersion,
+            coreVersion: getPluginCoreVersion(),
+            source: discovered.source,
+            plugin: discovered.plugin,
+            requiredCapabilities: discovered.requiredCapabilities,
+            capabilitySetDigest: discovered.capabilitySetDigest,
+            missingCapabilities: support.missing,
+            observations,
+            ...(hasBlockingObservation ? {
+                error: 'Plugin requirements contain an unmapped AW CLI command literal.',
+            } : {}),
+        };
+    }
+    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 fs.realpath(requestedPluginRoot);
+    const plugin = workspace.plugins.find((entry) => entry.rootDir === canonicalPluginRoot);
+    const expectedPluginRoot = plugin
+        ? 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,
+        workspaceRoot: workspace.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];
+        if (initialResolution.observations.some((observation) => observation.blocking)) {
+            throw new Error('Cannot mutate plugin requirements while an unmapped AW CLI command literal is present.');
+        }
+        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-context.d.ts

@@ -0,0 +1,52 @@
+export declare function getCatalogContext(options: {
+    cwd: string;
+    workspaceRoot?: string;
+    remote?: string;
+    branch?: string;
+    env: NodeJS.ProcessEnv;
+    awVersion: string;
+    capabilities: readonly string[];
+}): Promise<{
+    schemaVersion: number;
+    command: string;
+    toolchain: {
+        awVersion: string;
+        coreVersion: string;
+        capabilities: string[];
+        digest: string;
+    };
+    workspace: {
+        found: boolean;
+        root: string | null;
+        identity: string | null;
+        resolvedFrom: import("@lesliechan721/aw-plugin-core").CatalogWorkspaceResolvedFrom | null;
+    };
+    initialization: {
+        suggestedRoot: string | null;
+        resolvedFrom: import("@lesliechan721/aw-plugin-core").CatalogWorkspaceResolvedFrom | null;
+    };
+    git: {
+        repositoryRoot: string | null;
+        sourceHead: string | null;
+        clean: boolean | null;
+        remotes: string[];
+    };
+    publication: {
+        remote: string | null;
+        remoteResolvedFrom: import("./catalog-publication-target.js").CatalogRemoteResolvedFrom;
+        branch: string;
+        branchResolvedFrom: import("./catalog-publication-target.js").CatalogBranchResolvedFrom;
+        ambiguous: boolean;
+    };
+    developmentSource: {
+        snapshotPath: string;
+        suggestedSourceId: string;
+        existingSourceId: string | null;
+        active: boolean;
+    };
+    issues: {
+        code: string;
+        message: string;
+        blocking: boolean;
+    }[];
+}>;

package/dist/src/commands/catalog-context.js

@@ -0,0 +1,156 @@
+import { execFile } from 'node:child_process';
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { getPluginCoreVersion, readCatalogWorkspace, resolveCatalogWorkspaceRoot, } from '@lesliechan721/aw-plugin-core';
+import { resolveCatalogPublicationTarget } from './catalog-publication-target.js';
+import { suggestedCatalogDevSourceId } from './catalog-dev-source.js';
+import { sanitizedGitEnvironment } from './catalog-publication-inspection.js';
+import { CLI_RESERVED_IMPORTS } from '../utils/manifest.js';
+import { readCatalogSourcesConfigSnapshot } from '../utils/catalog-sources.js';
+const execFileAsync = promisify(execFile);
+function digest(value) {
+    return `sha256:${crypto.createHash('sha256').update(JSON.stringify(value)).digest('hex')}`;
+}
+async function git(cwd, args, env) {
+    try {
+        return (await execFileAsync('git', args, {
+            cwd,
+            env: { ...sanitizedGitEnvironment(env), GIT_OPTIONAL_LOCKS: '0' },
+            encoding: 'utf8',
+        })).stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+export async function getCatalogContext(options) {
+    const issues = [];
+    let existing = null;
+    let initialization = null;
+    let workspaceIdentity = null;
+    try {
+        existing = await resolveCatalogWorkspaceRoot({
+            cwd: options.cwd,
+            ...(options.workspaceRoot === undefined ? {} : { explicitRoot: options.workspaceRoot }),
+            mode: 'existing',
+        });
+        workspaceIdentity = (await readCatalogWorkspace(existing.workspaceRoot, {
+            reservedImports: CLI_RESERVED_IMPORTS,
+        })).workspaceIdentity;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const blocking = !message.startsWith('Catalog Workspace marker not found from:');
+        issues.push({
+            code: blocking ? 'workspaceInvalid' : 'workspaceUnavailable',
+            message,
+            blocking,
+        });
+    }
+    try {
+        initialization = await resolveCatalogWorkspaceRoot({
+            cwd: options.cwd,
+            ...(options.workspaceRoot === undefined ? {} : { explicitRoot: options.workspaceRoot }),
+            mode: 'initialize',
+        });
+    }
+    catch (error) {
+        if (!issues.some((issue) => issue.blocking)) {
+            issues.push({
+                code: 'workspaceInvalid',
+                message: error instanceof Error ? error.message : String(error),
+                blocking: true,
+            });
+        }
+    }
+    const inspectionRoot = existing?.workspaceRoot ?? initialization?.workspaceRoot ?? path.resolve(options.cwd);
+    const target = await resolveCatalogPublicationTarget({
+        workspaceRoot: inspectionRoot,
+        remote: options.remote,
+        branch: options.branch,
+        env: options.env,
+    });
+    const repositoryRoot = target.repositoryRoot;
+    const sourceHead = repositoryRoot ? await git(repositoryRoot, ['rev-parse', '--verify', 'HEAD'], options.env) : null;
+    const status = repositoryRoot
+        ? await git(repositoryRoot, ['status', '--porcelain=v1', '--untracked-files=all', '--ignore-submodules=none'], options.env)
+        : null;
+    const remotesText = repositoryRoot ? await git(repositoryRoot, ['remote'], options.env) : null;
+    const remotes = remotesText ? remotesText.split('\n').filter(Boolean).sort() : [];
+    const capabilities = [...options.capabilities].sort();
+    let suggestedSourceId = suggestedCatalogDevSourceId(inspectionRoot);
+    let existingSourceId = null;
+    let active = false;
+    if (workspaceIdentity !== null) {
+        try {
+            const sourceConfig = await readCatalogSourcesConfigSnapshot(options.env);
+            const owned = sourceConfig.config.sources.filter((source) => source.type === 'path'
+                && source.managedBy?.kind === 'catalog-workspace'
+                && source.managedBy.workspaceIdentity === workspaceIdentity);
+            if (owned.length > 1) {
+                issues.push({
+                    code: 'managedSourceAmbiguous',
+                    message: `Catalog Workspace owns multiple development sources: ${owned.map((source) => source.id).join(', ')}.`,
+                    blocking: true,
+                });
+            }
+            else if (owned.length === 1) {
+                existingSourceId = owned[0].id;
+                active = owned[0].path === path.join(inspectionRoot, '.aw', 'catalog');
+                suggestedSourceId = owned[0].id;
+            }
+            else {
+                suggestedSourceId = suggestedCatalogDevSourceId(inspectionRoot, workspaceIdentity, sourceConfig.config.sources.map((source) => source.id));
+            }
+        }
+        catch (error) {
+            issues.push({
+                code: 'sourceConfigInvalid',
+                message: error instanceof Error ? error.message : String(error),
+                blocking: true,
+            });
+        }
+    }
+    return {
+        schemaVersion: 1,
+        command: 'catalog:context',
+        toolchain: {
+            awVersion: options.awVersion,
+            coreVersion: getPluginCoreVersion(),
+            capabilities,
+            digest: digest({ awVersion: options.awVersion, coreVersion: getPluginCoreVersion(), capabilities }),
+        },
+        workspace: {
+            found: existing !== null && workspaceIdentity !== null,
+            root: existing?.workspaceRoot ?? null,
+            identity: workspaceIdentity,
+            resolvedFrom: existing?.workspaceRootResolvedFrom ?? null,
+        },
+        initialization: {
+            suggestedRoot: initialization?.workspaceRoot ?? null,
+            resolvedFrom: initialization?.workspaceRootResolvedFrom ?? null,
+        },
+        git: {
+            repositoryRoot,
+            sourceHead,
+            clean: status === null ? null : status === '',
+            remotes,
+        },
+        publication: {
+            remote: target.remote,
+            remoteResolvedFrom: target.remoteResolvedFrom,
+            branch: target.branch,
+            branchResolvedFrom: target.branchResolvedFrom,
+            ambiguous: target.ambiguous,
+        },
+        developmentSource: {
+            snapshotPath: path.join(inspectionRoot, '.aw', 'catalog'),
+            suggestedSourceId,
+            existingSourceId,
+            active,
+        },
+        issues,
+    };
+}
+//# sourceMappingURL=catalog-context.js.map

package/dist/src/commands/catalog-context.js.map

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

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

@@ -0,0 +1,112 @@
+import { type CatalogSourceCommandRuntime } from './catalog-source.js';
+type Issue = {
+    code: string;
+    message: string;
+    blocking: boolean;
+};
+export interface CatalogDevActivateReceipt {
+    receiptSchemaVersion: 1;
+    command: 'catalog:dev:activate';
+    ok: boolean;
+    state: 'completed' | 'partial';
+    workspaceIdentity: string | null;
+    snapshot: {
+        path: string;
+        action: 'reused' | 'built';
+        digest: string | null;
+    };
+    source: {
+        id: string;
+        action: 'added' | 'updated' | 'reused';
+        primary: boolean;
+    };
+    recovery: string[];
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export interface CatalogDevStatusReceipt {
+    receiptSchemaVersion: 1;
+    command: 'catalog:dev:status';
+    ok: boolean;
+    workspaceIdentity: string | null;
+    workspaceRoot: string;
+    snapshot: {
+        path: string;
+        state: 'absent' | 'current' | 'stale' | 'invalid';
+        valid: boolean;
+        digest: string | null;
+    };
+    source: {
+        exists: boolean;
+        id: string | null;
+        pathMatches: boolean | null;
+        primary: boolean | null;
+    };
+    cache: {
+        state: 'not-applicable' | 'absent' | 'current' | 'last-good';
+        validatedAt: string | null;
+        snapshotDigest: string | null;
+    };
+    issues: Issue[];
+}
+export interface CatalogDevDeactivateReceipt {
+    receiptSchemaVersion: 1;
+    command: 'catalog:dev:deactivate';
+    ok: boolean;
+    state: 'completed' | 'partial';
+    workspaceIdentity: string | null;
+    snapshotPath: string;
+    source: {
+        id: string | null;
+        action: 'removed' | 'absent' | 'retained';
+        previousPrimary: boolean;
+    };
+    replacementPrimarySourceId: string | null;
+    recovery: string[];
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export type CatalogDevSourceRuntime = {
+    sourceRuntime?: CatalogSourceCommandRuntime;
+};
+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 activateCatalogDevSource(options: {
+    cwd: string;
+    workspaceRoot?: string;
+    sourceId?: string;
+    primary?: boolean;
+    forceBuild?: boolean;
+    cliVersion: string;
+    env: NodeJS.ProcessEnv;
+    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;
+    env: NodeJS.ProcessEnv;
+    runtime?: CatalogDevSourceRuntime;
+}): Promise<CatalogDevDeactivateReceipt>;
+export {};