@lesliechan721/aw 0.1.0-beta.10

package/dist/src/adapters/helpers.d.ts

@@ -0,0 +1,44 @@
+import type { Scope } from '../types.js';
+export interface ClaudeSettings {
+    extraKnownMarketplaces?: Record<string, string | {
+        source: string | {
+            source: string;
+            path: string;
+        };
+    }>;
+    enabledPlugins?: Record<string, boolean | string[]>;
+    plugins?: {
+        installed?: Record<string, ClaudeSettingsInstalledRecord>;
+    };
+    permissions?: {
+        allow?: string[];
+        ask?: string[];
+        deny?: string[];
+    };
+    hooks?: Array<Record<string, unknown>>;
+    awGenerated?: {
+        permissions?: Record<string, {
+            allow: string[];
+            ask: string[];
+            deny: string[];
+        }>;
+        hooks?: Record<string, Array<Record<string, unknown>>>;
+        manualPermissions?: {
+            allow?: string[];
+            ask?: string[];
+            deny?: string[];
+        };
+        manualHooks?: Array<Record<string, unknown>>;
+    };
+}
+export interface ClaudeSettingsInstalledRecord {
+    marketplace: string;
+    version: string;
+    installedAt: string;
+    scope?: Scope;
+    projectPath?: string;
+    enabled?: boolean;
+    owner?: string;
+}
+export declare function readClaudeSettings(settingsPath: string): Promise<ClaudeSettings>;
+export declare function writeClaudeSettings(settingsPath: string, settings: ClaudeSettings): Promise<void>;

package/dist/src/adapters/helpers.js

@@ -0,0 +1,95 @@
+import path from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { atomicReplaceConfigFile, withConfigFileMutation, } from '../utils/plugin-config.js';
+import { readJsonFileIfExists } from '../utils/json.js';
+const claudeSettingsBaselines = new WeakMap();
+const DELETE_MERGED_VALUE = Symbol('delete-merged-value');
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function arrayIncludes(values, candidate) {
+    return values.some((value) => isDeepStrictEqual(value, candidate));
+}
+function removeBaselineValue(baseline, latest) {
+    if (latest === undefined)
+        return DELETE_MERGED_VALUE;
+    if (!isRecord(baseline) || !isRecord(latest)) {
+        return isDeepStrictEqual(baseline, latest)
+            ? DELETE_MERGED_VALUE
+            : structuredClone(latest);
+    }
+    const retained = structuredClone(latest);
+    for (const [key, baselineValue] of Object.entries(baseline)) {
+        if (!Object.hasOwn(retained, key))
+            continue;
+        const next = removeBaselineValue(baselineValue, retained[key]);
+        if (next === DELETE_MERGED_VALUE)
+            delete retained[key];
+        else
+            retained[key] = next;
+    }
+    return Object.keys(retained).length === 0 ? DELETE_MERGED_VALUE : retained;
+}
+function mergeClaudeSettingsChanges(baseline, desired, latest) {
+    if (isDeepStrictEqual(baseline, desired)) {
+        return structuredClone(latest);
+    }
+    if (Array.isArray(baseline) && Array.isArray(desired) && Array.isArray(latest)) {
+        const removed = baseline.filter((entry) => !arrayIncludes(desired, entry));
+        const added = desired.filter((entry) => !arrayIncludes(baseline, entry));
+        const merged = latest.filter((entry) => !arrayIncludes(removed, entry));
+        for (const entry of added) {
+            if (!arrayIncludes(merged, entry))
+                merged.push(structuredClone(entry));
+        }
+        return merged;
+    }
+    if (!isRecord(desired) || (!isRecord(baseline) && baseline !== undefined)) {
+        return structuredClone(desired);
+    }
+    const baselineRecord = isRecord(baseline) ? baseline : {};
+    const merged = isRecord(latest)
+        ? structuredClone(latest)
+        : {};
+    for (const key of new Set([...Object.keys(baselineRecord), ...Object.keys(desired)])) {
+        if (!Object.hasOwn(desired, key)) {
+            const next = removeBaselineValue(baselineRecord[key], merged[key]);
+            if (next === DELETE_MERGED_VALUE)
+                delete merged[key];
+            else
+                merged[key] = next;
+            continue;
+        }
+        if (!Object.hasOwn(baselineRecord, key)) {
+            merged[key] = mergeClaudeSettingsChanges(undefined, desired[key], merged[key]);
+            continue;
+        }
+        merged[key] = mergeClaudeSettingsChanges(baselineRecord[key], desired[key], isRecord(latest) ? latest[key] : undefined);
+    }
+    return merged;
+}
+export async function readClaudeSettings(settingsPath) {
+    const settings = await readJsonFileIfExists(settingsPath) ?? {};
+    claudeSettingsBaselines.set(settings, structuredClone(settings));
+    return settings;
+}
+export async function writeClaudeSettings(settingsPath, settings) {
+    const baseline = claudeSettingsBaselines.get(settings);
+    await withConfigFileMutation({
+        filePath: settingsPath,
+        allowedRoot: path.dirname(settingsPath),
+        action: async () => {
+            const latest = await readJsonFileIfExists(settingsPath) ?? {};
+            const next = baseline
+                ? mergeClaudeSettingsChanges(baseline, settings, latest)
+                : settings;
+            await atomicReplaceConfigFile({
+                filePath: settingsPath,
+                allowedRoot: path.dirname(settingsPath),
+                content: `${JSON.stringify(next, null, 2)}\n`,
+            });
+        },
+    });
+    claudeSettingsBaselines.set(settings, structuredClone(settings));
+}
+//# sourceMappingURL=helpers.js.map

package/dist/src/adapters/helpers.js.map

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

package/dist/src/authoring/workspace-commands.d.ts

@@ -0,0 +1,70 @@
+import { type CatalogVersionBump } from '@lesliechan721/aw-plugin-core';
+import type { CatalogWorkspaceResolvedFrom } from '../commands/catalog-workspace-resolution.js';
+export interface AuthoringCommandIo {
+    stdout(text: string): void;
+    stderr(text: string): void;
+}
+export declare function runCatalogInitCommand(options: {
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+    force?: boolean;
+    json?: boolean;
+    ownerName?: string;
+    ownerUrl?: string;
+    displayName?: string;
+    catalogVersion?: string;
+    io: AuthoringCommandIo;
+}): Promise<void>;
+export declare function runCatalogVersionCommand(options: {
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+    version?: string;
+    bump?: CatalogVersionBump;
+    json?: boolean;
+    io: AuthoringCommandIo;
+}): Promise<{
+    command: 'catalog:version';
+    ok: true;
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+    catalogVersion: string;
+    changed: boolean;
+}>;
+export declare function runCatalogBuildCommand(options: {
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+    out?: string;
+    force?: boolean;
+    json?: boolean;
+    io: AuthoringCommandIo;
+}): Promise<{
+    command: 'catalog:build';
+    ok: true;
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+    outputRoot: string;
+    catalogVersion: string;
+    channel: 'latest' | 'beta';
+    pluginNames: string[];
+}>;
+export declare function runCatalogValidateCommand(options: {
+    snapshotDirectory: string;
+    json?: boolean;
+    io: AuthoringCommandIo;
+}): Promise<void>;
+export declare function runPluginBuildCommand(options: {
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+    pluginDirectory: string;
+    out?: string;
+    force?: boolean;
+    json?: boolean;
+    io: AuthoringCommandIo;
+}): Promise<void>;
+export declare function runPluginTestCommand(options: {
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+    pluginDirectory: string;
+    json?: boolean;
+    io: AuthoringCommandIo;
+}): Promise<number>;

package/dist/src/authoring/workspace-commands.js

@@ -0,0 +1,158 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { buildCatalogWorkspace, buildCatalogWorkspacePlugin, initializeCatalogWorkspace, mutateCatalogWorkspaceVersion, readCatalogWorkspace, validateCatalogSnapshotComplete, } from '@lesliechan721/aw-plugin-core';
+import { bundleLocalPlugin, createCatalogRuntimeImportResolver, } from '../../scripts/plugin-staging.js';
+import { runPluginScriptTests } from '../../scripts/test-plugin-scripts.js';
+import { CLI_RESERVED_IMPORTS } from '../utils/manifest.js';
+const catalogBuildAdapter = {
+    async build(options) {
+        await bundleLocalPlugin(options.plugin, options.outputRoot, {
+            buildMode: 'staging',
+            runtimeResolver: createCatalogRuntimeImportResolver(options.plugins),
+        });
+    },
+};
+const pluginBuildAdapter = {
+    async build(options) {
+        await bundleLocalPlugin(options.plugin, options.outputRoot, {
+            buildMode: 'staging',
+            runtimeResolver: createCatalogRuntimeImportResolver(options.plugins),
+        });
+    },
+};
+function writeJson(io, value) {
+    io.stdout(`${JSON.stringify(value)}\n`);
+}
+export async function runCatalogInitCommand(options) {
+    const result = await initializeCatalogWorkspace(options);
+    const receipt = {
+        command: 'catalog:init',
+        ok: true,
+        workspaceRoot: result.workspaceRoot,
+        workspaceRootResolvedFrom: options.workspaceRootResolvedFrom,
+        metadataPath: result.metadataPath,
+        catalogVersion: result.metadata.catalog.version,
+    };
+    if (options.json)
+        writeJson(options.io, receipt);
+    else
+        options.io.stdout(`Catalog Workspace initialized at ${result.workspaceRoot}.\n`);
+}
+export async function runCatalogVersionCommand(options) {
+    if (options.version !== undefined && options.bump !== undefined) {
+        throw new Error('Catalog version accepts an exact version or --bump, not both.');
+    }
+    const current = await readCatalogWorkspace(options.workspaceRoot, {
+        reservedImports: CLI_RESERVED_IMPORTS,
+    });
+    const metadata = options.version === undefined && options.bump === undefined
+        ? current.metadata
+        : await mutateCatalogWorkspaceVersion(options.workspaceRoot, {
+            ...(options.version === undefined ? {} : { version: options.version }),
+            ...(options.bump === undefined ? {} : { bump: options.bump }),
+        }, { reservedImports: CLI_RESERVED_IMPORTS });
+    const receipt = {
+        command: 'catalog:version',
+        ok: true,
+        workspaceRoot: path.resolve(options.workspaceRoot),
+        workspaceRootResolvedFrom: options.workspaceRootResolvedFrom,
+        catalogVersion: metadata.catalog.version,
+        changed: metadata.catalog.version !== current.metadata.catalog.version,
+    };
+    if (options.json)
+        writeJson(options.io, receipt);
+    else
+        options.io.stdout(`${metadata.catalog.version}\n`);
+    return receipt;
+}
+export async function runCatalogBuildCommand(options) {
+    const result = await buildCatalogWorkspace({
+        workspaceRoot: options.workspaceRoot,
+        ...(options.out ? { outputPath: options.out } : {}),
+        force: options.force,
+        adapter: catalogBuildAdapter,
+        reservedImports: CLI_RESERVED_IMPORTS,
+    });
+    const receipt = {
+        command: 'catalog:build',
+        ok: true,
+        workspaceRoot: path.resolve(options.workspaceRoot),
+        workspaceRootResolvedFrom: options.workspaceRootResolvedFrom,
+        ...result,
+    };
+    if (options.json)
+        writeJson(options.io, receipt);
+    else
+        options.io.stdout(`Catalog snapshot built at ${result.outputRoot}.\n`);
+    return receipt;
+}
+export async function runCatalogValidateCommand(options) {
+    const result = await validateCatalogSnapshotComplete(options.snapshotDirectory);
+    const receipt = {
+        command: 'catalog:validate',
+        ok: true,
+        snapshotDirectory: result.rootDir,
+        catalogVersion: result.manifest.catalogVersion,
+        channel: result.manifest.channel,
+        snapshotDigest: result.snapshotDigest,
+    };
+    if (options.json)
+        writeJson(options.io, receipt);
+    else
+        options.io.stdout(`Catalog snapshot is valid: ${result.rootDir}.\n`);
+}
+export async function runPluginBuildCommand(options) {
+    const result = await buildCatalogWorkspacePlugin({
+        workspaceRoot: options.workspaceRoot,
+        pluginDirectory: options.pluginDirectory,
+        ...(options.out ? { outputPath: options.out } : {}),
+        force: options.force,
+        adapter: pluginBuildAdapter,
+        reservedImports: CLI_RESERVED_IMPORTS,
+    });
+    const receipt = {
+        command: 'plugin:build',
+        ok: true,
+        workspaceRoot: path.resolve(options.workspaceRoot),
+        workspaceRootResolvedFrom: options.workspaceRootResolvedFrom,
+        ...result,
+    };
+    if (options.json)
+        writeJson(options.io, receipt);
+    else
+        options.io.stdout(`Plugin bundle built at ${result.outputRoot}.\n`);
+}
+export async function runPluginTestCommand(options) {
+    const catalogWorkspace = await readCatalogWorkspace(options.workspaceRoot, { reservedImports: CLI_RESERVED_IMPORTS });
+    const pluginRoot = await fs.realpath(path.resolve(catalogWorkspace.workspaceRoot, options.pluginDirectory));
+    const plugin = catalogWorkspace.plugins.find((entry) => entry.rootDir === pluginRoot);
+    if (!plugin)
+        throw new Error(`Plugin directory is not part of this Catalog Workspace source: ${pluginRoot}`);
+    let stdout = '';
+    let stderr = '';
+    const exitCode = await runPluginScriptTests([plugin.manifest.name], {
+        repoRoot: catalogWorkspace.workspaceRoot,
+        stdout: (text) => { stdout += text; },
+        stderr: (text) => { stderr += text; },
+    });
+    if (options.json) {
+        writeJson(options.io, {
+            command: 'plugin:test',
+            ok: exitCode === 0,
+            workspaceRoot: catalogWorkspace.workspaceRoot,
+            workspaceRootResolvedFrom: options.workspaceRootResolvedFrom,
+            pluginName: plugin.manifest.name,
+            exitCode,
+            stdout,
+            stderr,
+        });
+    }
+    else {
+        if (stdout)
+            options.io.stdout(stdout);
+        if (stderr)
+            options.io.stderr(stderr);
+    }
+    return exitCode;
+}
+//# sourceMappingURL=workspace-commands.js.map

package/dist/src/authoring/workspace-commands.js.map

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

package/dist/src/commands/aw-capabilities.d.ts

@@ -0,0 +1,78 @@
+import { type AwPluginRequirementsReceiptV1, type PluginRequirementsResolution } from '@lesliechan721/aw-plugin-core/manifest';
+import { type CatalogWorkspaceResolvedFrom } from './catalog-workspace-resolution.js';
+export declare const IMPLEMENTED_AW_CAPABILITIES: readonly ["aw.plugin-manifest.v3", "aw.plugin-skills.v1", "aw.plugin-build-config.v1", "aw.plugin-config.v2", "aw.plugin-post-apply.v1", "aw.dynamic-artifacts.v2", "aw.portable-skills.v1", "aw.runtime-imports.v1", "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-publication.v1", "aw.catalog-snapshot.v7", "aw.self-check.v1"];
+export declare class AwCapabilityUnsupportedError extends Error {
+    readonly code = "awCapabilityUnsupported";
+    readonly plugin: string;
+    readonly missingCapabilities: string[];
+    readonly availableCapabilities: string[];
+    constructor(plugin: string, missingCapabilities: readonly string[]);
+}
+export interface AwSelfDescribeResult {
+    schemaVersion: 1;
+    command: 'self:describe';
+    awVersion: string;
+    coreVersion: string;
+    capabilities: string[];
+    capabilitySetDigest: string;
+}
+export declare function describeCurrentAw(awVersion: string): AwSelfDescribeResult;
+interface DiscoveredRequirements {
+    source: {
+        kind: 'receipt' | 'manifest';
+        path: string;
+    };
+    plugin: {
+        name: string;
+        version: string;
+    };
+    requiredCapabilities: string[];
+    capabilitySetDigest: string;
+    resolution?: PluginRequirementsResolution;
+}
+export declare function discoverAwPluginRequirements(from: string): Promise<DiscoveredRequirements>;
+export interface AwSelfCheckResult {
+    schemaVersion: 1;
+    command: 'self:check';
+    ok: boolean;
+    awVersion: string;
+    coreVersion: string;
+    source: DiscoveredRequirements['source'] | null;
+    plugin: DiscoveredRequirements['plugin'] | null;
+    requiredCapabilities: string[];
+    capabilitySetDigest: string | null;
+    missingCapabilities: string[];
+    observations: PluginRequirementsResolution['observations'];
+    error?: string;
+}
+export declare function checkCurrentAw(options: {
+    awVersion: string;
+    from: string;
+}): Promise<AwSelfCheckResult>;
+export interface PluginRequirementsResult extends PluginRequirementsResolution {
+    command: 'plugin:requirements';
+    plugin: {
+        name: string;
+        version: string;
+    };
+    pluginDirectory: string;
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+    mutation?: {
+        action: 'add' | 'remove';
+        capability: string;
+        changed: boolean;
+    };
+}
+export declare function inspectPluginRequirements(options: {
+    pluginDirectory: string;
+    workspaceRoot?: string;
+    cwd: string;
+    add?: string;
+    remove?: string;
+}): Promise<PluginRequirementsResult>;
+export declare function createRequirementsReceipt(plugin: {
+    name: string;
+    version: string;
+}, requiredCapabilities: string[]): AwPluginRequirementsReceiptV1;
+export {};