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

package/dist/src/review/skill-materialization.d.ts

@@ -0,0 +1,26 @@
+import type { PlatformName, PluginMeta, Scope } from '../types.js';
+import { type DynamicSkillTree } from '../utils/dynamic-skill-tree.js';
+import { type ManagedCommandCandidate } from '../utils/managed-command-materialization.js';
+export interface PreparedSkillPluginBundle {
+    bundleRoot: string;
+    bundlePlugin: PluginMeta;
+    cleanup(): Promise<void>;
+}
+export declare function prepareSkillPluginBundle(options: {
+    plugin: PluginMeta;
+    plugins: readonly PluginMeta[];
+    workRoot: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<PreparedSkillPluginBundle>;
+/** Prepare only producers referenced by these isolated Skill trees, without publishing bindings. */
+export declare function prepareIsolatedSkillCommandReferences(options: {
+    plugin: PluginMeta;
+    platform: PlatformName;
+    scope: Scope;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    trees: readonly DynamicSkillTree[];
+    candidates?: readonly ManagedCommandCandidate[];
+    scriptTimeoutMs?: number;
+}): Promise<ManagedCommandCandidate[]>;
+export declare function createIsolatedSkillEnv(baseEnv: NodeJS.ProcessEnv, scopeRoot: string): Promise<NodeJS.ProcessEnv>;

package/dist/src/review/skill-materialization.js

@@ -0,0 +1,217 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { getCommandPackageId, getManagedCommandArtifactTargets, parseManagedCommandPlaceholders, validateCommandEntryFiles, } from '@lesliechan721/aw-plugin-core/manifest';
+import { bundleLocalPlugin, prepareLocalPluginBundleSource } from '../generators/local-plugin.js';
+import { validateArtifactPlan } from '../utils/artifact-plan.js';
+import { runArtifactRenderer } from '../utils/artifact-renderer.js';
+import { createCatalogRuntimeImportResolver } from '../utils/catalog-runtime-projection.js';
+import { createCodexSkillExpectedTree } from '../utils/codex-skill-staging.js';
+import { createDynamicSkillExpectedTree, validateSkillDirectory, writeDynamicSkillTree, } from '../utils/dynamic-skill-tree.js';
+import { commandSetsForProducer, createManagedCommandReferenceResolver, managedCommandProducerIdentity, prepareManagedCommandPackage, resolveSkillManagedCommandReferences, } from '../utils/managed-command-materialization.js';
+import { validateManagedCommandResource } from '../utils/managed-command-store.js';
+import { createAwPluginRequirementsReceipt } from '../utils/manifest.js';
+import { prepareWindowsJobHelper } from '../utils/process-tree.js';
+import { injectInstalledRuntimeConfig } from '../utils/runtime-config.js';
+import { validateRuntimeSkillClosure } from '../utils/runtime-skill-closure.js';
+export async function prepareSkillPluginBundle(options) {
+    await fs.ensureDir(options.workRoot);
+    const tempRoot = await fs.mkdtemp(path.join(options.workRoot, 'bundle-'));
+    let prepared;
+    try {
+        prepared = await prepareLocalPluginBundleSource(options.plugin, {
+            buildMode: 'staging',
+            commandEnv: options.env,
+            runtimeResolver: createCatalogRuntimeImportResolver(options.plugins),
+        });
+        const activePrepared = prepared;
+        const bundleRoot = path.join(tempRoot, 'bundle');
+        await bundleLocalPlugin(activePrepared.plugin, bundleRoot, {
+            buildMode: 'prepared',
+            preparedRuntimeContext: activePrepared.runtimeContext,
+        });
+        const manifestPath = path.join(bundleRoot, '.agents-plugin', 'plugin.json');
+        const manifest = await fs.readJson(manifestPath);
+        return {
+            bundleRoot,
+            bundlePlugin: {
+                ...activePrepared.plugin,
+                rootDir: bundleRoot,
+                manifestPath,
+                manifest,
+            },
+            cleanup: async () => {
+                await activePrepared.cleanup();
+                await fs.remove(tempRoot);
+            },
+        };
+    }
+    catch (error) {
+        await prepared?.cleanup();
+        await fs.remove(tempRoot);
+        throw error;
+    }
+}
+/** Prepare only producers referenced by these isolated Skill trees, without publishing bindings. */
+export async function prepareIsolatedSkillCommandReferences(options) {
+    const candidates = [...(options.candidates ?? [])];
+    const pending = options.trees.map((tree) => ({ tree, scope: options.scope }));
+    const prepared = new Set(candidates.map((candidate) => getCommandPackageId(candidate.producer)));
+    const temporaryRoots = [];
+    const referencedTrees = new Set();
+    try {
+        for (let index = 0; index < pending.length; index += 1) {
+            const consumer = pending[index];
+            const references = Object.entries(consumer.tree.files)
+                .filter(([relativePath]) => relativePath.endsWith('.md'))
+                .flatMap(([, content]) => parseManagedCommandPlaceholders(content.toString('utf8')));
+            if (references.length > 0)
+                referencedTrees.add(consumer.tree);
+            if (references.length > 0
+                && !options.plugin.manifest.requires?.aw.capabilities?.includes('aw.managed-commands.v1')) {
+                throw new Error('commandReferenceInvalid: managed command references require aw.managed-commands.v1.');
+            }
+            for (const { reference } of references) {
+                const set = options.plugin.manifest.managedCommands?.sets.find((entry) => entry.set === reference.set);
+                if (!set)
+                    throw new Error('commandReferenceInvalid: the command set is not declared by this plugin.');
+                const producerRef = set.producer;
+                const declaration = producerRef.kind === 'artifact'
+                    ? options.plugin.manifest.artifacts?.targets?.find((target) => target.id === producerRef.artifactId)
+                    : undefined;
+                if (producerRef.kind === 'static-skill' && producerRef.platform !== options.platform
+                    || producerRef.kind === 'artifact' && (declaration?.platform !== options.platform
+                        || declaration.delivery?.mode !== 'codex-native' && !declaration.scopes.includes(consumer.scope))) {
+                    throw new Error('commandReferenceInvalid: the producer is unavailable on this platform and scope.');
+                }
+                if (producerRef.kind === 'package') {
+                    const commandPackage = options.plugin.manifest.managedCommands?.packages.find((entry) => entry.key === producerRef.packageKey);
+                    if (!commandPackage?.platforms.includes(options.platform)
+                        || consumer.scope === 'user' && commandPackage.scope === 'project') {
+                        throw new Error('commandReferenceInvalid: the command package is unavailable to this consumer.');
+                    }
+                }
+                const producer = await managedCommandProducerIdentity({
+                    ...options, producer: producerRef, scope: consumer.scope,
+                });
+                const identity = getCommandPackageId(producer);
+                if (prepared.has(identity))
+                    continue;
+                prepared.add(identity);
+                if (producerRef.kind === 'package') {
+                    const commandPackage = await prepareManagedCommandPackage({
+                        ...options, packageKey: producerRef.packageKey, scope: producer.scope, event: 'materialize',
+                    });
+                    candidates.push({ producer: commandPackage.producer, sets: commandPackage.sets });
+                    await commandPackage.cleanup();
+                    continue;
+                }
+                const commandTargets = getManagedCommandArtifactTargets(options.plugin.manifest).filter((target) => JSON.stringify(target.producer) === JSON.stringify(producerRef));
+                const requestedArtifactIds = [
+                    ...(producerRef.kind === 'artifact' ? [producerRef.artifactId] : []),
+                    ...commandTargets.map((target) => target.id),
+                ];
+                let artifacts = [];
+                let tree;
+                let resourceRoot;
+                let render;
+                if (requestedArtifactIds.length > 0) {
+                    if (process.platform === 'win32') {
+                        await prepareWindowsJobHelper();
+                    }
+                    render = await runArtifactRenderer({
+                        plugin: options.plugin,
+                        platform: options.platform,
+                        scope: producer.scope,
+                        ...(declaration?.delivery?.mode === 'codex-native' ? { configScope: 'user' } : {}),
+                        event: 'materialize', cwd: options.cwd, commandEnv: options.env,
+                        requestedArtifactIds, previousArtifacts: [], scriptTimeoutMs: options.scriptTimeoutMs,
+                    });
+                    artifacts = validateArtifactPlan({
+                        manifest: options.plugin.manifest, plan: render.plan,
+                        platform: options.platform, scope: producer.scope,
+                        requestedArtifactIds: render.context.requestedArtifactIds,
+                        renderConfig: render.context.config,
+                        rendererDigest: render.target.rendererDigest, manifestDigest: render.target.manifestDigest,
+                    }).artifacts;
+                }
+                if (producerRef.kind === 'static-skill') {
+                    resourceRoot = path.join(options.plugin.rootDir, options.platform, 'skills', producerRef.skillKey);
+                    tree = await validateSkillDirectory(resourceRoot, `${options.platform}.skill`, {
+                        requirementsReceiptPolicy: 'allow',
+                    });
+                }
+                else {
+                    const artifact = artifacts.find((entry) => entry.id === producerRef.artifactId);
+                    if (!artifact || artifact.state !== 'present'
+                        || artifact.target !== 'codex.skill' && artifact.target !== 'claude.skill') {
+                        throw new Error('commandReferenceInvalid: the producer did not produce a present Skill.');
+                    }
+                    const sourceDirs = render.context.artifactSources.find((source) => source.id === artifact.id && source.target === artifact.target)?.sourceDirs ?? [];
+                    const receipt = createAwPluginRequirementsReceipt(options.plugin.manifest, options.plugin.manifest.requires?.aw.capabilities ?? []);
+                    const treeOptions = {
+                        sourceDirs, requireReadme: true,
+                        requirementsReceipt: Buffer.from(`${JSON.stringify(receipt, null, 2)}\n`),
+                        sourceRequirementsReceiptPolicy: 'allow',
+                    };
+                    tree = artifact.target === 'codex.skill'
+                        ? await createCodexSkillExpectedTree({ ...treeOptions, artifact })
+                        : await createDynamicSkillExpectedTree({ ...treeOptions, artifact });
+                    await injectInstalledRuntimeConfig(tree, render.runtimeConfigSnapshots[artifact.id]);
+                    const temporaryRoot = await fs.mkdtemp(path.join(options.env.TMPDIR, 'aw-review-command-'));
+                    temporaryRoots.push(temporaryRoot);
+                    resourceRoot = path.join(temporaryRoot, tree.skillKey);
+                    await writeDynamicSkillTree(resourceRoot, tree);
+                }
+                const sets = commandSetsForProducer({ plugin: options.plugin, producer: producerRef, artifacts });
+                await validateManagedCommandResource(resourceRoot);
+                await validateCommandEntryFiles(resourceRoot, sets.flatMap((entry) => entry.entries));
+                await validateRuntimeSkillClosure(resourceRoot);
+                candidates.push({ producer, sets });
+                pending.push({ tree, scope: producer.scope });
+            }
+        }
+        for (const { tree, scope } of pending) {
+            if (!referencedTrees.has(tree))
+                continue;
+            const resolve = await createManagedCommandReferenceResolver({ ...options, scope, candidates });
+            resolveSkillManagedCommandReferences(tree, resolve);
+        }
+        return candidates;
+    }
+    finally {
+        await Promise.all(temporaryRoots.map((root) => fs.remove(root)));
+    }
+}
+export async function createIsolatedSkillEnv(baseEnv, scopeRoot) {
+    const home = path.join(scopeRoot, 'home');
+    const temp = path.join(scopeRoot, 'tmp');
+    const codexHome = path.join(scopeRoot, 'codex-home');
+    const env = {
+        ...baseEnv,
+        HOME: home,
+        USERPROFILE: home,
+        XDG_CACHE_HOME: path.join(scopeRoot, 'xdg-cache'),
+        XDG_CONFIG_HOME: path.join(scopeRoot, 'xdg-config'),
+        XDG_STATE_HOME: path.join(scopeRoot, 'xdg-state'),
+        TMPDIR: temp,
+        TEMP: temp,
+        TMP: temp,
+        AW_HOME: path.join(scopeRoot, 'aw-home'),
+        AW_CODEX_HOME: codexHome,
+        AW_CLAUDE_HOME: path.join(scopeRoot, 'claude-home'),
+        CODEX_HOME: codexHome,
+        NODE_PATH: '',
+    };
+    await Promise.all([
+        fs.ensureDir(env.HOME),
+        fs.ensureDir(env.XDG_CACHE_HOME),
+        fs.ensureDir(env.XDG_CONFIG_HOME),
+        fs.ensureDir(env.XDG_STATE_HOME),
+        fs.ensureDir(env.TMPDIR),
+        fs.ensureDir(env.AW_HOME),
+        fs.ensureDir(env.AW_CODEX_HOME),
+        fs.ensureDir(env.AW_CLAUDE_HOME),
+    ]);
+    return env;
+}
+//# sourceMappingURL=skill-materialization.js.map

package/dist/src/review/skill-materialization.js.map

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

package/dist/src/review/source-binding.d.ts

@@ -0,0 +1,183 @@
+import { type CatalogWorkspace } from '@lesliechan721/aw-plugin-core';
+import type { AwSkillEvalMaterializationProfile } from '../../scripts/aw-skill-eval-materializer.js';
+import { type AwSkillEvalManifestV1Profile } from '../eval/manifest-v1.js';
+import type { CatalogSourceResolution, PluginMeta, Scope } from '../types.js';
+import { type ResolvedArtifactRenderConfig } from '../utils/artifact-renderer.js';
+import { type AwSourceBindingEvalInput } from './eval-source-input.js';
+import type { ReviewProfile, ReviewProfileConfig } from './review-types.js';
+export { computeAwSourceBindingSelectedCasesDigest, computeAwSourceBindingSuiteDefaultsDigest, resolveAwSourceBindingEvalProvider, resolveEvalSourceBindingInput, selectAwSourceBindingEvalCases, type AwSourceBindingEvalCaseSelection, type AwSourceBindingEvalInput, type ResolvedEvalSourceBindingInput, } from './eval-source-input.js';
+export declare const AW_SOURCE_BINDING_FILENAME = "aw-source-binding.json";
+export interface AwWorkspaceBindingSource {
+    kind: 'workspace';
+    workspaceIdentity: string;
+    sourceIdentity: string;
+}
+export interface AwCatalogSnapshotBindingSource {
+    kind: 'catalog-snapshot';
+    sourceId: string;
+    catalogSourceIdentity: string;
+    logicalIdentity: string;
+    snapshotDigest: string;
+    workspaceIdentity: string;
+    workspaceSourceIdentity: string;
+}
+export type AwSourceBindingSource = AwWorkspaceBindingSource | AwCatalogSnapshotBindingSource;
+export interface AwSourceBindingSubject {
+    plugin: string;
+    skill?: string;
+    suite?: string;
+}
+export type AwSourceBindingProfile = {
+    kind: 'eval';
+    id: string;
+    scope: Scope;
+    inputDigest: string;
+    config?: ReviewProfileConfig;
+} | {
+    kind: 'portable';
+    id: `agent-skills-${Scope}`;
+    scope: Scope;
+    inputDigest: string;
+} | ReviewProfile;
+export type AwSourceBindingArtifact = {
+    kind: 'eval-target';
+    skill: string;
+    path: string;
+    digest: string;
+} | {
+    kind: 'eval-workspace';
+    path: string;
+    digest: string;
+} | {
+    kind: 'eval-cases';
+    path: string;
+    digest: string;
+} | {
+    kind: 'portable-skill';
+    plugin: string;
+    skill: string;
+    path: string;
+    digest: string;
+} | {
+    kind: 'review-skill';
+    plugin: string;
+    skill: string;
+    path: string;
+    digest: string;
+};
+export type AwSourceBindingArtifactInput = {
+    kind: 'eval-target';
+    skill: string;
+    path: string;
+} | {
+    kind: 'eval-workspace';
+    path: string;
+} | {
+    kind: 'eval-cases';
+    path: string;
+} | {
+    kind: 'portable-skill';
+    plugin: string;
+    skill: string;
+    path: string;
+} | {
+    kind: 'review-skill';
+    plugin: string;
+    skill: string;
+    path: string;
+};
+export type AwSourceBindingVerifiedOutput = AwSourceBindingArtifact;
+export interface AwSourceBindingV2 {
+    schemaVersion: 2;
+    kind: 'aw-source-binding';
+    source: AwSourceBindingSource;
+    subject: AwSourceBindingSubject;
+    profile: AwSourceBindingProfile;
+    evalInput?: AwSourceBindingEvalInput;
+    artifacts: AwSourceBindingArtifact[];
+    finalDigest: string;
+}
+export interface AwSourceBindingIssue {
+    code: 'sourceBindingMissing' | 'sourceBindingInvalid' | 'sourceBindingSubjectDrift' | 'sourceBindingSourceDrift' | 'sourceBindingProfileDrift' | 'sourceBindingEvalInputDrift' | 'sourceBindingArtifactDrift';
+    message: string;
+}
+export type AwSourceBindingValidation = {
+    state: 'verified';
+    binding: AwSourceBindingV2;
+    outputs: AwSourceBindingVerifiedOutput[];
+    issues: [];
+} | {
+    state: 'incomplete' | 'invalid' | 'drifted';
+    binding: AwSourceBindingV2 | null;
+    outputs: [];
+    issues: AwSourceBindingIssue[];
+};
+export interface WriteAwSourceBindingOptions {
+    rootDir: string;
+    source: AwSourceBindingSource;
+    subject: AwSourceBindingSubject;
+    profile: AwSourceBindingProfile;
+    evalInput?: AwSourceBindingEvalInput;
+    artifacts: AwSourceBindingArtifactInput[];
+}
+export interface AwSourceBindingWorkspaceValidationContext {
+    workspace: CatalogWorkspace;
+    source: AwWorkspaceBindingSource;
+}
+export interface EvalProfileBindingInput {
+    profile: AwSourceBindingProfile & {
+        kind: 'eval';
+    };
+    materializationProfile: AwSkillEvalMaterializationProfile;
+}
+export interface PortablePluginProfileConfig {
+    config: ResolvedArtifactRenderConfig;
+    digest: string;
+}
+export declare function parseAwSourceBinding(value: unknown): AwSourceBindingV2;
+export declare function writeAwSourceBinding(options: WriteAwSourceBindingOptions): Promise<{
+    bindingPath: string;
+    binding: AwSourceBindingV2;
+}>;
+export declare function resolveWorkspaceBindingSource(workspace: Pick<CatalogWorkspace, 'workspaceRoot' | 'workspaceIdentity' | 'metadataPath' | 'plugins'>): Promise<AwWorkspaceBindingSource>;
+export declare function resolveCatalogSnapshotBindingSource(source: Pick<CatalogSourceResolution, 'sourceId' | 'sourceIdentity' | 'logicalIdentity' | 'snapshotDigest' | 'rootDir'>): Promise<AwCatalogSnapshotBindingSource>;
+export declare function resolveEvalProfileBindingInput(profile: AwSkillEvalManifestV1Profile, plugins: readonly PluginMeta[], configOverrides?: ReviewProfileConfig): EvalProfileBindingInput;
+export declare function resolvePortablePluginProfileConfig(options: {
+    plugin: PluginMeta;
+    scope: Scope;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    sourceId?: string;
+    catalogSourceIdentity?: string;
+    logicalIdentity?: string;
+}): Promise<PortablePluginProfileConfig>;
+export declare function resolvePortableProfileBindingInput(options: {
+    plugins: readonly PluginMeta[];
+    pluginName: string;
+    scope: Scope;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    sourceId?: string;
+    catalogSourceIdentity?: string;
+    logicalIdentity?: string;
+}): Promise<AwSourceBindingProfile & {
+    kind: 'portable';
+}>;
+export declare function resolveCurrentWorkspaceAwSourceBinding(options: {
+    context: AwSourceBindingWorkspaceValidationContext;
+    binding: AwSourceBindingV2;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
+    source: AwWorkspaceBindingSource;
+    profile: AwSourceBindingProfile;
+}>;
+export declare function createAwSourceBindingWorkspaceValidationContext(workspaceRoot: string): Promise<AwSourceBindingWorkspaceValidationContext>;
+export declare function readAwSourceBinding(bindingPath: string): Promise<AwSourceBindingV2>;
+export declare function validateAwSourceBindingForWorkspace(options: {
+    bindingPath: string;
+    context: AwSourceBindingWorkspaceValidationContext;
+    expectedSubject: AwSourceBindingSubject;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<AwSourceBindingValidation>;