@lesliechan721/aw 0.1.0-beta.64 → 0.1.0-beta.65

package/dist/src/portable/writer.js

@@ -0,0 +1,316 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { isPortablePlatformTarget } from '@lesliechan721/aw-plugin-core';
+import fs from 'fs-extra';
+import { validatePortableSkillDirectory, validatePortableSkillFrontmatter, validatePortableSkillName, } from '../utils/dynamic-skill-tree.js';
+import { assertSafeOwnershipSegment, SKILL_OWNER_MARKER } from '../utils/ownership.js';
+import { atomicReplaceSafeFile } from '../utils/safe-fs.js';
+import { ensureRegularDirectoryPath } from '../utils/state-paths.js';
+import { validateRuntimeSkillClosure } from '../utils/runtime-skill-closure.js';
+import { assertPortablePath, portableJsonDigest } from './historical-materialization.js';
+function isDigest(value) {
+    return typeof value === 'string' && /^sha256:[a-f0-9]{64}$/u.test(value);
+}
+function parseIdentity(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const row = value;
+    if (Object.keys(row).some((key) => !['schemaVersion', 'owner', 'kind', 'pluginId',
+        'logicalIdentity', 'platform', 'scope', 'skill', 'filesDigest', 'configDigest'].includes(key)))
+        return undefined;
+    if (row.schemaVersion !== 1 || row.owner !== 'agent-workflows' || row.kind !== 'portable-skill'
+        || typeof row.pluginId !== 'string' || typeof row.logicalIdentity !== 'string'
+        || !row.logicalIdentity || !isPortablePlatformTarget(row.platform)
+        || (row.scope !== 'user' && row.scope !== 'project') || typeof row.skill !== 'string')
+        return undefined;
+    const parts = row.pluginId.split('/');
+    if (parts.length !== 2)
+        return undefined;
+    try {
+        for (const part of parts)
+            assertSafeOwnershipSegment(part, 'Portable plugin identity');
+        validatePortableSkillName(row.skill);
+    }
+    catch {
+        return undefined;
+    }
+    return { pluginId: row.pluginId, logicalIdentity: row.logicalIdentity,
+        platform: row.platform, scope: row.scope, skill: row.skill };
+}
+function sameIdentity(left, right) {
+    return left.pluginId === right.pluginId && left.logicalIdentity === right.logicalIdentity
+        && left.platform === right.platform && left.scope === right.scope && left.skill === right.skill;
+}
+function parseOwner(value) {
+    const identity = parseIdentity(value);
+    if (!identity)
+        return undefined;
+    const row = value;
+    if (!isDigest(row.filesDigest) || !isDigest(row.configDigest)
+        || Object.keys(row).some((key) => !['schemaVersion', 'owner', 'kind', 'pluginId',
+            'logicalIdentity', 'platform', 'scope', 'skill', 'filesDigest', 'configDigest'].includes(key)))
+        return undefined;
+    return { schemaVersion: 1, owner: 'agent-workflows', kind: 'portable-skill', ...identity,
+        filesDigest: row.filesDigest, configDigest: row.configDigest };
+}
+/** Includes every regular content file; the weak owner evidence is not Skill content. */
+export async function portableOwnedTreeDigest(root) {
+    const files = [];
+    const visit = async (directory, prefix) => {
+        const info = await fs.lstat(directory);
+        if (!info.isDirectory() || info.isSymbolicLink())
+            throw new Error('portableOutputConflict');
+        for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
+            const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+            const absolute = path.join(directory, entry.name);
+            const stat = await fs.lstat(absolute);
+            if (stat.isSymbolicLink())
+                throw new Error('portableOutputConflict');
+            if (stat.isDirectory())
+                await visit(absolute, relative);
+            else if (stat.isFile()) {
+                if (relative !== SKILL_OWNER_MARKER)
+                    files.push([relative, await fs.readFile(absolute)]);
+            }
+            else
+                throw new Error('portableOutputConflict');
+        }
+    };
+    await visit(root, '');
+    const hash = crypto.createHash('sha256');
+    for (const [name, bytes] of files.sort(([left], [right]) => left.localeCompare(right))) {
+        hash.update(name).update('\0').update(bytes).update('\0');
+    }
+    return `sha256:${hash.digest('hex')}`;
+}
+/** A marker only proves the bounded AW resource, never current installation health. */
+export async function observePortableSkill(options) {
+    validatePortableSkillName(options.skill);
+    const physicalPath = options.physicalPath ?? path.join(options.destinationRoot, options.skill);
+    const base = { skill: options.skill, physicalPath, ownership: 'unknown',
+        observation: 'unknown', contentState: 'unknown', evidenceDigest: '' };
+    const finish = (result, evidence) => {
+        const merged = { ...base, ...result };
+        return { ...merged, evidenceDigest: portableJsonDigest({ physicalPath,
+                installedDigest: merged.installedDigest, owner: merged.owner,
+                recoverableIdentity: merged.recoverableIdentity, ownership: merged.ownership, evidence }) };
+    };
+    try {
+        if (!path.isAbsolute(options.destinationRoot) || path.dirname(physicalPath) !== path.resolve(options.destinationRoot)) {
+            return finish({ observation: 'conflict', blocker: 'portableOutputConflict' }, 'boundary');
+        }
+        if (!await assertPortablePath(path.parse(physicalPath).root, physicalPath)) {
+            return finish({ observation: 'absent' }, 'absent');
+        }
+        const stat = await fs.lstat(physicalPath);
+        if (!stat.isDirectory() || stat.isSymbolicLink()) {
+            return finish({ ownership: 'external', observation: 'conflict', blocker: 'portableOutputConflict' }, 'type');
+        }
+        const markerPath = path.join(physicalPath, SKILL_OWNER_MARKER);
+        const markerStat = await fs.lstat(markerPath).catch((error) => {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        });
+        if (!markerStat)
+            return finish({ ownership: 'external', observation: 'conflict',
+                blocker: 'portableOutputConflict' }, { dev: stat.dev, ino: stat.ino, marker: 'absent' });
+        if (!markerStat.isFile() || markerStat.isSymbolicLink()) {
+            return finish({ ownership: 'external', observation: 'conflict', blocker: 'portableOutputConflict' }, 'marker-type');
+        }
+        const raw = await fs.readFile(markerPath, 'utf8');
+        const evidence = { dev: stat.dev, ino: stat.ino, marker: portableJsonDigest(raw) };
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return finish({ blocker: 'portableOwnerInvalid' }, evidence);
+        }
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            const row = parsed;
+            if (row.owner !== undefined && row.owner !== 'agent-workflows'
+                || row.kind !== undefined && row.kind !== 'portable-skill'
+                || row.schemaVersion !== undefined && row.schemaVersion !== 1) {
+                return finish({ ownership: 'external', observation: 'conflict', blocker: 'portableOutputConflict' }, evidence);
+            }
+        }
+        const identity = parseIdentity(parsed);
+        if (!identity || identity.skill !== options.skill)
+            return finish({ blocker: 'portableOwnerInvalid' }, evidence);
+        if (options.identity && !sameIdentity(identity, options.identity)) {
+            return finish({ ownership: 'external', observation: 'conflict', blocker: 'portableOutputConflict' }, evidence);
+        }
+        const owner = parseOwner(parsed);
+        const installedDigest = await portableOwnedTreeDigest(physicalPath);
+        if (!owner)
+            return finish({ ownership: 'aw', observation: 'drifted', contentState: 'damaged',
+                installedDigest, recoverableIdentity: identity, blocker: 'portableOwnerDamaged' }, evidence);
+        const observed = { owner, recoverableIdentity: identity, installedDigest, ownership: 'aw' };
+        if (installedDigest !== owner.filesDigest) {
+            return finish({ ...observed, observation: 'drifted', contentState: 'damaged' }, evidence);
+        }
+        try {
+            validatePortableSkillFrontmatter(await fs.readFile(path.join(physicalPath, 'SKILL.md'), 'utf8'), options.skill);
+            if (!(await fs.readFile(path.join(physicalPath, 'README.md'), 'utf8')).trim())
+                throw new Error('missing-readme');
+            await validateRuntimeSkillClosure(physicalPath);
+        }
+        catch {
+            return finish({ ...observed, observation: 'drifted', contentState: 'damaged' }, evidence);
+        }
+        const stale = options.expectedDigest !== undefined && installedDigest !== options.expectedDigest
+            || options.configDigest !== undefined && owner.configDigest !== options.configDigest;
+        return finish({ ...observed, observation: stale ? 'drifted' : 'satisfied',
+            contentState: stale ? 'stale' : 'current' }, evidence);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === 'portableOutputConflict') {
+            return finish({ observation: 'conflict', blocker: 'portableOutputConflict' }, 'unsafe-path');
+        }
+        return finish({ blocker: 'portableObservationFailed' }, 'unavailable');
+    }
+}
+export async function scanPortableSkills(options) {
+    const targets = [];
+    try {
+        options.signal?.throwIfAborted();
+        if (!await assertPortablePath(path.parse(options.destinationRoot).root, options.destinationRoot)) {
+            return { targets, complete: true };
+        }
+        const rootStat = await fs.lstat(options.destinationRoot);
+        if (!rootStat.isDirectory() || rootStat.isSymbolicLink())
+            return { targets, complete: false };
+        let complete = true;
+        for (const entry of await fs.readdir(options.destinationRoot, { withFileTypes: true })) {
+            options.signal?.throwIfAborted();
+            try {
+                validatePortableSkillName(entry.name);
+            }
+            catch {
+                continue;
+            }
+            const target = await observePortableSkill({ destinationRoot: options.destinationRoot, skill: entry.name });
+            const identity = target.owner ?? target.recoverableIdentity;
+            if (identity && (identity.platform !== options.platform || identity.scope !== options.scope))
+                continue;
+            // Markerless and foreign resources are not AW inventory or adoption candidates.
+            if (target.ownership === 'external')
+                continue;
+            if (target.observation === 'unknown' || target.observation === 'conflict')
+                complete = false;
+            targets.push(target);
+        }
+        return { targets, complete };
+    }
+    catch (error) {
+        options.signal?.throwIfAborted();
+        if (error instanceof Error && error.name === 'AbortError')
+            throw error;
+        return { targets, complete: false };
+    }
+}
+function assertSnapshot(actual, expected) {
+    if (actual.evidenceDigest !== expected.evidenceDigest)
+        throw new Error('operationReviewStale');
+}
+/** Stage and validate a complete real copy before changing the discoverable output. */
+export async function publishPortableSkill(options) {
+    const owner = { schemaVersion: 1, owner: 'agent-workflows', kind: 'portable-skill',
+        ...options.identity, filesDigest: options.expectedDigest, configDigest: options.configDigest };
+    if (!parseOwner(owner))
+        throw new Error('portableOwnerInvalid');
+    const target = path.join(options.destinationRoot, owner.skill);
+    if (options.observed.physicalPath !== target
+        || !['absent', 'satisfied', 'drifted'].includes(options.observed.observation)
+        || (options.observed.observation !== 'absent' && options.observed.ownership !== 'aw')) {
+        throw new Error('portableOutputConflict');
+    }
+    await assertPortablePath(path.parse(options.sourceDir).root, options.sourceDir);
+    await validatePortableSkillDirectory(options.sourceDir);
+    await validateRuntimeSkillClosure(options.sourceDir);
+    if (await portableOwnedTreeDigest(options.sourceDir) !== options.expectedDigest)
+        throw new Error('operationReviewStale');
+    await ensureRegularDirectoryPath(options.destinationRoot, 'Portable destination');
+    const staging = await fs.mkdtemp(path.join(path.dirname(options.destinationRoot), '.aw-portable-stage-'));
+    const stagingStat = await fs.lstat(staging);
+    const stagedSkill = path.join(staging, owner.skill);
+    const old = path.join(staging, 'previous');
+    let moved = false;
+    try {
+        await fs.copy(options.sourceDir, stagedSkill, { dereference: false, errorOnExist: true });
+        await validatePortableSkillDirectory(stagedSkill);
+        await validateRuntimeSkillClosure(stagedSkill);
+        if (await portableOwnedTreeDigest(stagedSkill) !== options.expectedDigest)
+            throw new Error('operationReviewStale');
+        await atomicReplaceSafeFile({ filePath: path.join(stagedSkill, SKILL_OWNER_MARKER), allowedRoot: staging,
+            content: `${JSON.stringify(owner, null, 2)}\n`, label: 'Portable owner', temporaryTag: 'owner' });
+        const current = await observePortableSkill({ destinationRoot: options.destinationRoot,
+            identity: options.identity, skill: owner.skill, expectedDigest: options.expectedDigest, configDigest: options.configDigest });
+        assertSnapshot(current, options.observed);
+        if (current.observation !== 'absent') {
+            await fs.rename(target, old);
+            moved = true;
+            const oldStat = await fs.lstat(old);
+            const oldMarker = await fs.readJson(path.join(old, SKILL_OWNER_MARKER));
+            const oldIdentity = parseIdentity(oldMarker);
+            if (!oldStat.isDirectory() || oldStat.isSymbolicLink() || !oldIdentity
+                || !sameIdentity(oldIdentity, owner)
+                || await portableOwnedTreeDigest(old) !== current.installedDigest)
+                throw new Error('portableOutputConflict');
+        }
+        await assertPortablePath(path.parse(options.destinationRoot).root, options.destinationRoot);
+        await fs.rename(stagedSkill, target);
+        moved = false;
+    }
+    catch (error) {
+        if (moved && !await fs.lstat(target).catch(() => undefined)) {
+            await fs.rename(old, target).then(() => { moved = false; }).catch(() => undefined);
+        }
+        throw error;
+    }
+    finally {
+        // This operation created staging. A failed restore retains the old weak output for manual recovery.
+        if (!moved) {
+            try {
+                await assertPortablePath(path.parse(staging).root, staging);
+                const current = await fs.lstat(staging);
+                if (current.isDirectory() && !current.isSymbolicLink()
+                    && current.dev === stagingStat.dev && current.ino === stagingStat.ino)
+                    await fs.remove(staging);
+            }
+            catch { /* Keep weak staging when its path can no longer be verified. */ }
+        }
+    }
+}
+/** Force only tolerates damaged digest metadata with a complete matching AW identity. */
+export async function removePortableSkill(options) {
+    const current = await observePortableSkill({ destinationRoot: options.destinationRoot,
+        skill: options.identity.skill, identity: options.identity });
+    assertSnapshot(current, options.observed);
+    if (current.observation === 'absent')
+        return;
+    if (current.ownership !== 'aw' || !current.recoverableIdentity
+        || !sameIdentity(current.recoverableIdentity, options.identity)
+        || (current.blocker && !(options.force && current.blocker === 'portableOwnerDamaged'))) {
+        throw new Error(current.blocker ?? 'portableOutputConflict');
+    }
+    const quarantine = path.join(options.destinationRoot, `.aw-portable-remove-${crypto.randomUUID()}`);
+    await fs.rename(current.physicalPath, quarantine);
+    try {
+        await assertPortablePath(path.parse(quarantine).root, quarantine);
+        const marker = await fs.readJson(path.join(quarantine, SKILL_OWNER_MARKER));
+        const identity = parseIdentity(marker);
+        if (!identity || !sameIdentity(identity, options.identity)
+            || await portableOwnedTreeDigest(quarantine) !== current.installedDigest)
+            throw new Error('portableOutputConflict');
+        await fs.remove(quarantine);
+    }
+    catch (error) {
+        if (!await fs.lstat(current.physicalPath).catch(() => undefined)) {
+            await fs.rename(quarantine, current.physicalPath).catch(() => undefined);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/src/portable/writer.js.map

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

package/dist/src/recovery/coordinator.d.ts

@@ -0,0 +1,137 @@
+import type { CatalogGenerationActiveV1, CatalogGenerationCandidateEvidence, CatalogSourceImpact, InstallCommandOptions, PlatformName, PlatformSelection, Scope } from '../types.js';
+import type { CliPrompt } from '../commands/runtime.js';
+import { type PreApplyAuthorizationTarget, type RebuildCommandResult, type RebuildCommandRuntime } from '../commands/rebuild-command.js';
+import { type PortablePreparation, type PortableResidue, type PortableTarget } from '../portable/recovery.js';
+import { type DemandSnapshot } from './demand.js';
+import { type AgentId, type DeploymentPreferences } from '../intent/deployment-preferences.js';
+import { type ScopeContext } from '../intent/scope-context.js';
+import type { RecoveryReceipt } from './receipt.js';
+import { type JointRecoveryState } from './joint-coordinator.js';
+export type RecoveryCommand = 'sync' | 'install' | 'reinstall' | 'uninstall' | 'cleanup';
+export interface RecoveryOptions {
+    signal?: AbortSignal;
+    scope?: Scope;
+    context?: Scope;
+    existingOnly?: boolean;
+    retireUnselectedTargets?: boolean;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    cliVersion: string;
+    targets?: readonly string[];
+    all?: boolean;
+    yes?: boolean;
+    force?: boolean;
+    refresh?: boolean;
+    allowManagedCodexInstall?: boolean;
+    scriptTimeoutMs?: number;
+    interactive?: boolean;
+    prompt?: CliPrompt;
+    exactTargets?: readonly {
+        pluginId: string;
+        agent: AgentId;
+        scope?: Scope;
+    }[];
+    /** Derived per-operation provider assignments, never a user preference. */
+    dependencyScopeOverrides?: InstallCommandOptions['dependencyScopeOverrides'];
+    demandOverride?: DemandSnapshot;
+    excludedPluginIds?: string[];
+    /** Reviewed scoped activation work for an existing shared Native provider. */
+    nativeActivationOnlyTargets?: Array<{
+        pluginId: string;
+        platform: PlatformName;
+        scope: Scope;
+    }>;
+    /** Preview-only exits which are independently checked by owned cleanup plans. */
+    nativePlannedRetirements?: Array<{
+        pluginId: string;
+        platform: PlatformName;
+        scope: Scope;
+    }>;
+}
+interface NativeTarget {
+    pluginId: string;
+    platform: PlatformName;
+}
+interface NativeGroup {
+    pluginIds: string[];
+    platform: PlatformSelection;
+    targets?: NativeTarget[];
+    command: RecoveryCommand;
+    preview: RebuildCommandResult;
+}
+export interface RecoverySourceRefresh {
+    sourceId: string;
+    candidate: CatalogGenerationCandidateEvidence;
+    previousActive: CatalogGenerationActiveV1 | null;
+    configDigest: string;
+    impact: CatalogSourceImpact;
+    impactDigest: string;
+}
+export interface RecoveryPlan {
+    command: RecoveryCommand;
+    options: RecoveryOptions & {
+        scope: Scope;
+    };
+    joint?: JointRecoveryState;
+    receipt: RecoveryReceipt;
+    plannedImpact: {
+        declaration: boolean;
+        preferences: boolean;
+        config: boolean;
+        outputs: boolean;
+    };
+    changes: string[];
+    warnings: string[];
+    demand: DemandSnapshot;
+    context: ScopeContext;
+    originalIntent: string;
+    preferencesEvidence: string;
+    declaration?: string[];
+    preferences?: DeploymentPreferences;
+    nativeGroups: NativeGroup[];
+    historicalNativeTargets: Set<string>;
+    deliverySwitchChecks: Array<{
+        pluginIds: string[];
+        cleanPluginIds: string[];
+        platform: PlatformName;
+        fingerprint: string;
+    }>;
+    portableGroups: PortablePreparation[];
+    portableProtectionGroups: PortablePreparation[];
+    preApplyAuthorization?: PreApplyAuthorizationTarget[];
+    runtime: RebuildCommandRuntime;
+    portableResidues: Array<{
+        kind: 'cleanup' | 'delivery-switch';
+        pluginId: string;
+        agents: AgentId[];
+        observation: PortableResidue;
+        retainedTargets?: PortableTarget[];
+    }>;
+    sourceRefreshes: RecoverySourceRefresh[];
+    sourceRefreshFailures: Array<{
+        sourceId: string;
+        code: string;
+    }>;
+    blockExecution: boolean;
+}
+/** Run the reviewed replacement's hooks before any dependent old-output cleanup. */
+export declare function executeRecoveryPreApply(plan: RecoveryPlan, pluginId: string, agent: AgentId, runtime: RebuildCommandRuntime): Promise<string | undefined>;
+export declare function prepareScopedRecovery(command: RecoveryCommand, selectors: readonly string[], options: RecoveryOptions & {
+    scope: Scope;
+}, runtime?: RebuildCommandRuntime): Promise<RecoveryPlan>;
+export declare function activateRecoverySourcesAndReprepare(plan: RecoveryPlan, execution?: {
+    runtime?: RebuildCommandRuntime;
+}): Promise<RecoveryPlan>;
+export declare function executeScopedRecovery(plan: RecoveryPlan, execution?: {
+    yes?: boolean;
+    runtime?: RebuildCommandRuntime;
+}): Promise<RecoveryReceipt>;
+export declare function runRecovery(command: RecoveryCommand, selectors: readonly string[], options: RecoveryOptions, runtime?: RebuildCommandRuntime): Promise<RecoveryReceipt>;
+export declare function prepareRecovery(command: RecoveryCommand, selectors: readonly string[], options: RecoveryOptions, runtime?: RebuildCommandRuntime): Promise<RecoveryPlan>;
+export declare function executeRecovery(plan: RecoveryPlan, execution?: {
+    yes?: boolean;
+    runtime?: RebuildCommandRuntime;
+}): Promise<RecoveryReceipt>;
+/** Review evidence uses existing backend fingerprints and observation digests; it is not stored state. */
+export declare function describeRecoveryPlan(plan: RecoveryPlan): unknown;
+export {};