@lesliechan721/aw 0.1.0-beta.3 → 0.1.0-beta.30

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

@@ -0,0 +1,13 @@
+import type { PluginMeta } from '../types.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>;
+export declare function createIsolatedSkillEnv(baseEnv: NodeJS.ProcessEnv, scopeRoot: string): Promise<NodeJS.ProcessEnv>;

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

@@ -0,0 +1,75 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { bundleLocalPlugin, prepareLocalPluginBundleSource } from '../generators/local-plugin.js';
+import { createCatalogRuntimeImportResolver } from '../utils/catalog-runtime-projection.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;
+    }
+}
+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,182 @@
+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 } 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;
+} | {
+    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[]): 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>;