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

package/dist/src/intent/deployment-preferences.d.ts

@@ -0,0 +1,63 @@
+import type { PlatformTarget, Scope } from '../types.js';
+import { type AwHomeMutationToken } from '../utils/aw-home-mutation-lock.js';
+export type AgentId = PlatformTarget;
+export interface DeploymentExclusion {
+    plugin: string;
+    target: AgentId;
+}
+export interface DeploymentPreferences {
+    schemaVersion: 2;
+    kind: 'aw-deployment-preferences';
+    targets: AgentId[];
+    exclusions: DeploymentExclusion[];
+}
+export interface PreferencesLocation {
+    scope: Scope;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    token?: AwHomeMutationToken;
+}
+export type PreferencesObservation = {
+    state: 'absent';
+} | {
+    state: 'valid';
+    value: DeploymentPreferences;
+    digest: string;
+    rawBytes: Buffer;
+    rawDigest: string;
+} | {
+    state: 'invalid';
+    code: 'deploymentPreferencesInvalid';
+    digest?: string;
+    rawBytes?: Buffer;
+    rawDigest?: string;
+} | {
+    state: 'unreadable';
+    code: 'deploymentPreferencesUnavailable';
+};
+export interface PreferencesWriteResult {
+    value: DeploymentPreferences;
+    changed: boolean;
+}
+export interface AgentSelection {
+    agents: AgentId[];
+    origin: 'argument' | 'preference' | 'none';
+    preferences: PreferencesObservation['state'];
+}
+export declare function normalizeAgents(values: readonly string[]): AgentId[];
+export declare function normalizeExclusions(value: unknown): DeploymentExclusion[];
+export declare function createEmptyPreferences(): DeploymentPreferences;
+export declare function parsePreferences(value: unknown, _scope?: Scope): DeploymentPreferences;
+export declare function serializePreferences(value: DeploymentPreferences, scope: Scope): string;
+export declare function resolvePreferencesPath(location: PreferencesLocation): Promise<string>;
+export declare function observePreferences(location: PreferencesLocation): Promise<PreferencesObservation>;
+export declare function writePreferences(location: PreferencesLocation, value: DeploymentPreferences): Promise<PreferencesWriteResult>;
+export declare function setAgents(location: PreferencesLocation, agents: readonly string[]): Promise<PreferencesWriteResult>;
+export declare function resetTargets(location: PreferencesLocation): Promise<PreferencesWriteResult>;
+export declare function selectAgents(options: {
+    preferences: PreferencesObservation;
+    targets?: readonly string[];
+}): AgentSelection;
+export declare const setTargets: typeof setAgents;
+/** The caller supplies a complete joint-demand check; it runs under the same write lock. */
+export declare function setExclusions(location: PreferencesLocation, exclusions: readonly DeploymentExclusion[], validate: (draft: DeploymentPreferences) => Promise<void>): Promise<PreferencesWriteResult>;

package/dist/src/intent/deployment-preferences.js

@@ -0,0 +1,170 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { isPlatformTarget } from '@lesliechan721/aw-plugin-core';
+import { parsePluginId } from '../utils/multi-source-catalog.js';
+import { withAwHomeMutationLock } from '../utils/aw-home-mutation-lock.js';
+import { atomicReplaceConfigFile } from '../utils/plugin-config.js';
+import { assertSafeFileMutationPath } from '../utils/safe-fs.js';
+import { resolveAbsoluteAwHome, } from '../utils/state-paths.js';
+import { assertTestReadablePath, assertTestWritablePath } from '../utils/test-path-fence.js';
+import { describeStrongStateProblem } from './diagnostics.js';
+const compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+const digestBytes = (bytes) => `sha256:${crypto.createHash('sha256').update(bytes).digest('hex')}`;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assertKeys(value, expected, label) {
+    if (Object.keys(value).length !== expected.length
+        || Object.keys(value).some((key) => !expected.includes(key))) {
+        throw new Error(`Invalid ${label} fields.`);
+    }
+}
+export function normalizeAgents(values) {
+    return [...new Set(values.map((value) => {
+            if (isPlatformTarget(value))
+                return value;
+            throw new Error('Invalid Agent ID.');
+        }))].sort(compareText);
+}
+export function normalizeExclusions(value) {
+    if (!Array.isArray(value))
+        throw new Error('Invalid deployment exclusions.');
+    const result = value.map((entry) => {
+        if (!isRecord(entry))
+            throw new Error('Invalid deployment exclusion.');
+        assertKeys(entry, ['plugin', 'target'], 'deployment exclusion');
+        if (typeof entry.plugin !== 'string' || typeof entry.target !== 'string')
+            throw new Error('Invalid deployment exclusion.');
+        const parsed = parsePluginId(entry.plugin);
+        if (!parsed.sourceId)
+            throw new Error('Deployment exclusion requires source/plugin.');
+        return { plugin: `${parsed.sourceId}/${parsed.pluginName}`, target: normalizeAgents([entry.target])[0] };
+    });
+    const keys = result.map((entry) => `${entry.plugin}\0${entry.target}`);
+    if (new Set(keys).size !== keys.length)
+        throw new Error('Duplicate deployment exclusion.');
+    return result.sort((a, b) => compareText(`${a.plugin}\0${a.target}`, `${b.plugin}\0${b.target}`));
+}
+export function createEmptyPreferences() {
+    return { schemaVersion: 2, kind: 'aw-deployment-preferences', targets: [], exclusions: [] };
+}
+export function parsePreferences(value, _scope) {
+    if (!isRecord(value))
+        throw new Error('Invalid deployment preferences.');
+    assertKeys(value, ['schemaVersion', 'kind', 'targets', 'exclusions'], 'deployment preferences');
+    if (value.schemaVersion !== 2 || value.kind !== 'aw-deployment-preferences') {
+        throw new Error('Invalid deployment preferences version or kind.');
+    }
+    if (!Array.isArray(value.targets))
+        throw new Error('Invalid deployment Agents.');
+    return {
+        schemaVersion: 2, kind: 'aw-deployment-preferences',
+        targets: normalizeAgents(value.targets),
+        exclusions: normalizeExclusions(value.exclusions),
+    };
+}
+export function serializePreferences(value, scope) {
+    return `${JSON.stringify(parsePreferences(value, scope), null, 2)}\n`;
+}
+export async function resolvePreferencesPath(location) {
+    const awHome = resolveAbsoluteAwHome(location.env);
+    return path.join(awHome, 'deployment-preferences.json');
+}
+function invalidPath(error) {
+    return error instanceof Error && /(?:symbolic link|regular (?:directory|file)|escapes its allowed root)/iu
+        .test(error.message);
+}
+export async function observePreferences(location) {
+    try {
+        const allowedRoot = resolveAbsoluteAwHome(location.env);
+        const filePath = await resolvePreferencesPath(location);
+        assertTestReadablePath(filePath, 'deployment preferences', '用隔离 AW_HOME 登记可读路径。');
+        await assertSafeFileMutationPath({ filePath, allowedRoot, label: 'Deployment preferences' });
+        let rawBytes;
+        try {
+            rawBytes = await fs.readFile(filePath);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return { state: 'absent' };
+            throw error;
+        }
+        const rawDigest = digestBytes(rawBytes);
+        try {
+            const value = parsePreferences(JSON.parse(rawBytes.toString('utf8')), location.scope);
+            return { state: 'valid', value, digest: rawDigest, rawBytes, rawDigest };
+        }
+        catch {
+            return { state: 'invalid', code: 'deploymentPreferencesInvalid', digest: rawDigest,
+                rawBytes, rawDigest };
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError')
+            throw error;
+        return invalidPath(error)
+            ? { state: 'invalid', code: 'deploymentPreferencesInvalid' }
+            : { state: 'unreadable', code: 'deploymentPreferencesUnavailable' };
+    }
+}
+async function mutatePreferences(location, update, allowInvalid = false) {
+    return withAwHomeMutationLock({ env: location.env, token: location.token, action: async () => {
+            const observation = await observePreferences(location);
+            if (observation.state === 'unreadable') {
+                const diagnostic = describeStrongStateProblem({ kind: 'preferences', scope: 'user',
+                    state: observation.state, filePath: await resolvePreferencesPath(location) });
+                throw new Error(`${diagnostic.code}: ${diagnostic.message}`);
+            }
+            if (observation.state === 'invalid' && !allowInvalid) {
+                const diagnostic = describeStrongStateProblem({ kind: 'preferences', scope: 'user',
+                    state: observation.state, filePath: await resolvePreferencesPath(location) });
+                throw new Error(`${diagnostic.code}: ${diagnostic.message}`);
+            }
+            const current = observation.state === 'valid' ? observation.value : createEmptyPreferences();
+            const next = parsePreferences(update(current), location.scope);
+            if (observation.state !== 'invalid' && JSON.stringify(next) === JSON.stringify(current)) {
+                return { value: current, changed: false };
+            }
+            const allowedRoot = resolveAbsoluteAwHome(location.env);
+            const filePath = await resolvePreferencesPath(location);
+            assertTestWritablePath(filePath, 'deployment preferences', '用隔离 AW_HOME 登记可写路径。');
+            await atomicReplaceConfigFile({ filePath, allowedRoot, content: serializePreferences(next, location.scope) });
+            return { value: next, changed: true };
+        } });
+}
+export function writePreferences(location, value) {
+    return mutatePreferences(location, () => value);
+}
+export function setAgents(location, agents) {
+    const normalized = normalizeAgents(agents);
+    return mutatePreferences(location, (current) => ({ ...current, targets: normalized }));
+}
+export function resetTargets(location) {
+    return mutatePreferences(location, createEmptyPreferences, true);
+}
+export function selectAgents(options) {
+    const { preferences, targets } = options;
+    if (preferences.state === 'invalid' || preferences.state === 'unreadable') {
+        throw new Error(`Cannot select Agents with ${preferences.state} preferences.`);
+    }
+    if (targets !== undefined) {
+        return { agents: normalizeAgents(targets), origin: 'argument', preferences: preferences.state };
+    }
+    const agents = preferences.state === 'valid' ? preferences.value.targets : [];
+    return { agents, origin: agents.length > 0 ? 'preference' : 'none', preferences: preferences.state };
+}
+export const setTargets = setAgents;
+/** The caller supplies a complete joint-demand check; it runs under the same write lock. */
+export async function setExclusions(location, exclusions, validate) {
+    const normalized = normalizeExclusions(exclusions);
+    return withAwHomeMutationLock({ env: location.env, token: location.token, action: async (token) => {
+            const observed = await observePreferences(location);
+            if (observed.state !== 'valid' && observed.state !== 'absent')
+                throw new Error('deploymentPreferencesInvalid');
+            const next = { ...(observed.state === 'valid' ? observed.value : createEmptyPreferences()), exclusions: normalized };
+            await validate(next);
+            return writePreferences({ ...location, token }, next);
+        } });
+}
+//# sourceMappingURL=deployment-preferences.js.map

package/dist/src/intent/deployment-preferences.js.map

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

package/dist/src/intent/diagnostics.d.ts

@@ -0,0 +1,11 @@
+import type { Scope } from '../types.js';
+export interface StrongStateDiagnostic {
+    code: string;
+    message: string;
+}
+export declare function describeStrongStateProblem(options: {
+    kind: 'intent' | 'preferences';
+    scope: Scope;
+    state: 'unsupported-version' | 'invalid' | 'unreadable';
+    filePath: string;
+}): StrongStateDiagnostic;

package/dist/src/intent/diagnostics.js

@@ -0,0 +1,14 @@
+export function describeStrongStateProblem(options) {
+    const { kind, scope, state, filePath } = options;
+    const code = kind === 'intent' ? 'pluginIntentStateInvalid' : 'deploymentPreferencesInvalid';
+    const status = state === 'unsupported-version' ? '版本不受支持'
+        : state === 'invalid' ? '格式无效' : '无法读取';
+    const action = kind === 'intent'
+        ? `修复路径或移走旧文件，再用 aw plugin intent add <source/plugin> --scope ${scope} 逐项重建。`
+        : `修复路径，再用 aw plugin targets reset 显式重建部署偏好。`;
+    return {
+        code,
+        message: `${scope} ${kind === 'intent' ? '插件声明' : '部署偏好'}${status}：${filePath}。先备份此文件的原始内容，再${action}`,
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/src/intent/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/intent/diagnostics.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,0BAA0B,CAAC,OAK1C;IACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,8BAA8B,CAAC;IAC7F,MAAM,MAAM,GAAG,KAAK,KAAK,qBAAqB,CAAC,CAAC,CAAC,QAAQ;QACvD,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,KAAK,QAAQ;QAC9B,CAAC,CAAC,8DAA8D,KAAK,QAAQ;QAC7E,CAAC,CAAC,2CAA2C,CAAC;IAChD,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,GAAG,KAAK,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,QAAQ,iBAAiB,MAAM,EAAE;KACvG,CAAC;AACJ,CAAC"}

package/dist/src/intent/intent-codec.d.ts

@@ -0,0 +1,19 @@
+export interface PluginIntent {
+    schemaVersion: 3;
+    kind: 'aw-plugin-intents';
+    sources: Record<string, {
+        logicalIdentity: string;
+    }>;
+    roots: Array<{
+        pluginId: string;
+    }>;
+}
+export declare const INTENT_SCHEMA_VERSION = 3;
+export declare const INTENT_KIND = "aw-plugin-intents";
+export declare function canonicalPluginId(value: unknown): string;
+export declare function createEmptyIntent(): PluginIntent;
+export declare function parseIntent(value: unknown): PluginIntent;
+export declare function serializeIntent(value: PluginIntent): string;
+export declare function calculateIntentDigest(value: PluginIntent): string;
+export declare function addIntentRoot(value: PluginIntent, pluginId: string, logicalIdentity: string): PluginIntent;
+export declare function removeIntentRoot(value: PluginIntent, pluginId: string): PluginIntent;

package/dist/src/intent/intent-codec.js

@@ -0,0 +1,117 @@
+import crypto from 'node:crypto';
+import { parsePluginId } from '../utils/multi-source-catalog.js';
+export const INTENT_SCHEMA_VERSION = 3;
+export const INTENT_KIND = 'aw-plugin-intents';
+const compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assertKeys(value, expected, label) {
+    if (Object.keys(value).length !== expected.length
+        || Object.keys(value).some((key) => !expected.includes(key))) {
+        throw new Error(`Invalid ${label} fields.`);
+    }
+}
+export function canonicalPluginId(value) {
+    if (typeof value !== 'string')
+        throw new Error('Invalid plugin ID.');
+    const parsed = parsePluginId(value);
+    if (!parsed.sourceId)
+        throw new Error('Invalid plugin ID: source required.');
+    return `${parsed.sourceId}/${parsed.pluginName}`;
+}
+function canonicalSources(value) {
+    if (!isRecord(value))
+        throw new Error('Invalid intent sources.');
+    const result = {};
+    for (const sourceId of Object.keys(value).sort(compareText)) {
+        const parsed = parsePluginId(`${sourceId}/placeholder`);
+        if (parsed.sourceId !== sourceId)
+            throw new Error('Invalid intent source ID.');
+        const binding = value[sourceId];
+        if (!isRecord(binding))
+            throw new Error('Invalid intent source binding.');
+        assertKeys(binding, ['logicalIdentity'], 'intent source binding');
+        if (typeof binding.logicalIdentity !== 'string'
+            || binding.logicalIdentity.trim() === ''
+            || binding.logicalIdentity !== binding.logicalIdentity.trim()) {
+            throw new Error('Invalid intent source logical identity.');
+        }
+        result[sourceId] = { logicalIdentity: binding.logicalIdentity };
+    }
+    return result;
+}
+export function createEmptyIntent() {
+    return { schemaVersion: INTENT_SCHEMA_VERSION, kind: INTENT_KIND, sources: {}, roots: [] };
+}
+export function parseIntent(value) {
+    if (!isRecord(value))
+        throw new Error('Invalid plugin intent.');
+    assertKeys(value, ['schemaVersion', 'kind', 'sources', 'roots'], 'plugin intent');
+    if (value.schemaVersion !== INTENT_SCHEMA_VERSION || value.kind !== INTENT_KIND) {
+        throw new Error('Invalid plugin intent version or kind.');
+    }
+    const sources = canonicalSources(value.sources);
+    if (!Array.isArray(value.roots))
+        throw new Error('Invalid intent roots.');
+    const roots = value.roots.map((root) => {
+        if (!isRecord(root))
+            throw new Error('Invalid intent root.');
+        assertKeys(root, ['pluginId'], 'intent root');
+        return { pluginId: canonicalPluginId(root.pluginId) };
+    });
+    const ids = roots.map((root) => root.pluginId);
+    if (new Set(ids).size !== ids.length)
+        throw new Error('Invalid intent roots: duplicate plugin ID.');
+    for (const root of roots) {
+        if (!sources[root.pluginId.split('/')[0]]) {
+            throw new Error('Invalid intent roots: source binding missing.');
+        }
+    }
+    return {
+        schemaVersion: INTENT_SCHEMA_VERSION,
+        kind: INTENT_KIND,
+        sources,
+        roots: roots.sort((a, b) => compareText(a.pluginId, b.pluginId)),
+    };
+}
+export function serializeIntent(value) {
+    return `${JSON.stringify(parseIntent(value), null, 2)}\n`;
+}
+export function calculateIntentDigest(value) {
+    return `sha256:${crypto.createHash('sha256').update(JSON.stringify(parseIntent(value))).digest('hex')}`;
+}
+export function addIntentRoot(value, pluginId, logicalIdentity) {
+    const current = parseIntent(value);
+    const canonicalId = canonicalPluginId(pluginId);
+    const sourceId = canonicalId.split('/')[0];
+    if (typeof logicalIdentity !== 'string' || logicalIdentity.trim() !== logicalIdentity
+        || logicalIdentity === '')
+        throw new Error('Invalid source logical identity.');
+    const existing = current.sources[sourceId];
+    if (existing && existing.logicalIdentity !== logicalIdentity) {
+        throw new Error('sourceIdentityConflict: source alias has another logical identity.');
+    }
+    if (current.roots.some((root) => root.pluginId === canonicalId))
+        return current;
+    return parseIntent({
+        ...current,
+        sources: { ...current.sources, [sourceId]: { logicalIdentity } },
+        roots: [...current.roots, { pluginId: canonicalId }],
+    });
+}
+export function removeIntentRoot(value, pluginId) {
+    const current = parseIntent(value);
+    const canonicalId = canonicalPluginId(pluginId);
+    const roots = current.roots.filter((root) => root.pluginId !== canonicalId);
+    if (roots.length === current.roots.length)
+        return current;
+    const removedSource = canonicalId.split('/')[0];
+    const sourceStillUsed = roots.some((root) => root.pluginId.split('/')[0] === removedSource);
+    return parseIntent({
+        ...current,
+        sources: Object.fromEntries(Object.entries(current.sources).filter(([id]) => id !== removedSource || sourceStillUsed)),
+        roots,
+    });
+}
+//# sourceMappingURL=intent-codec.js.map

package/dist/src/intent/intent-codec.js.map

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

package/dist/src/intent/intent-store.d.ts

@@ -0,0 +1,43 @@
+import type { Scope } from '../types.js';
+import { type AwHomeMutationToken } from '../utils/aw-home-mutation-lock.js';
+import { type ProjectSharedConfigVisibility } from '../utils/project-boundary.js';
+import { type PluginIntent } from './intent-codec.js';
+export interface IntentLocation {
+    scope: Scope;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    token?: AwHomeMutationToken;
+}
+interface ReadEvidence {
+    rawBytes: Buffer;
+    rawDigest: string;
+}
+export type IntentObservation = {
+    state: 'absent';
+} | ({
+    state: 'valid';
+    value: PluginIntent;
+    digest: string;
+} & ReadEvidence) | ({
+    state: 'unsupported-version';
+    schemaVersion: number;
+    digest: string;
+} & ReadEvidence) | ({
+    state: 'invalid';
+    code: 'pluginIntentStateInvalid';
+    digest?: string;
+} & Partial<ReadEvidence>) | {
+    state: 'unreadable';
+    code: 'pluginIntentStateUnavailable';
+};
+export interface IntentWriteResult {
+    value: PluginIntent;
+    changed: boolean;
+    visibility?: ProjectSharedConfigVisibility;
+}
+export declare function resolveIntentPath(location: IntentLocation): Promise<string>;
+export declare function observeIntent(location: IntentLocation): Promise<IntentObservation>;
+export declare function writeIntent(location: IntentLocation, value: PluginIntent): Promise<IntentWriteResult>;
+export declare function addRoot(location: IntentLocation, pluginId: string, logicalIdentity: string): Promise<IntentWriteResult>;
+export declare function removeRoot(location: IntentLocation, pluginId: string): Promise<IntentWriteResult>;
+export {};

package/dist/src/intent/intent-store.js

@@ -0,0 +1,118 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { withAwHomeMutationLock } from '../utils/aw-home-mutation-lock.js';
+import { atomicReplaceConfigFile } from '../utils/plugin-config.js';
+import { assertCanonicalProjectManagedRoots, assertProjectSharedConfigPathVisible, } from '../utils/project-boundary.js';
+import { assertSafeFileMutationPath } from '../utils/safe-fs.js';
+import { resolveAbsoluteAwHome, resolveRequiredCanonicalRepoRoot } from '../utils/state-paths.js';
+import { assertTestReadablePath, assertTestWritablePath } from '../utils/test-path-fence.js';
+import { addIntentRoot, calculateIntentDigest, createEmptyIntent, parseIntent, removeIntentRoot, serializeIntent, } from './intent-codec.js';
+import { describeStrongStateProblem } from './diagnostics.js';
+const digestBytes = (bytes) => `sha256:${crypto.createHash('sha256').update(bytes).digest('hex')}`;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function invalidPath(error) {
+    return error instanceof Error && /(?:symbolic link|regular (?:directory|file)|escapes its allowed root|符号链接|realpath 越界|必须位于 repo 内)/iu
+        .test(error.message);
+}
+async function intentPath(location, access) {
+    const allowedRoot = location.scope === 'user'
+        ? resolveAbsoluteAwHome(location.env)
+        : await assertCanonicalProjectManagedRoots({
+            cwd: await resolveRequiredCanonicalRepoRoot(location.cwd),
+            rootNames: [], managedPaths: ['.agent-workflows'],
+        });
+    const filePath = location.scope === 'user'
+        ? path.join(allowedRoot, 'plugin-intents.json')
+        : path.join(allowedRoot, '.agent-workflows', 'plugin-intents.json');
+    const message = '用隔离 AW_HOME 或 project 根登记可读写路径。';
+    if (access === 'read')
+        assertTestReadablePath(filePath, 'plugin intent', message);
+    else
+        assertTestWritablePath(filePath, 'plugin intent', message);
+    return { allowedRoot, filePath };
+}
+export async function resolveIntentPath(location) {
+    if (location.scope === 'user')
+        return path.join(resolveAbsoluteAwHome(location.env), 'plugin-intents.json');
+    return path.join(await resolveRequiredCanonicalRepoRoot(location.cwd), '.agent-workflows', 'plugin-intents.json');
+}
+export async function observeIntent(location) {
+    try {
+        const { allowedRoot, filePath } = await intentPath(location, 'read');
+        await assertSafeFileMutationPath({ filePath, allowedRoot, label: 'Plugin intent' });
+        let rawBytes;
+        try {
+            rawBytes = await fs.readFile(filePath);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return { state: 'absent' };
+            throw error;
+        }
+        const rawDigest = digestBytes(rawBytes);
+        let parsed;
+        try {
+            parsed = JSON.parse(rawBytes.toString('utf8'));
+        }
+        catch {
+            return { state: 'invalid', code: 'pluginIntentStateInvalid', digest: rawDigest, rawBytes, rawDigest };
+        }
+        if (!isRecord(parsed) || parsed.kind !== 'aw-plugin-intents'
+            || !Number.isInteger(parsed.schemaVersion)) {
+            return { state: 'invalid', code: 'pluginIntentStateInvalid', digest: rawDigest, rawBytes, rawDigest };
+        }
+        if (parsed.schemaVersion !== 3) {
+            return { state: 'unsupported-version', schemaVersion: parsed.schemaVersion,
+                digest: rawDigest, rawBytes, rawDigest };
+        }
+        try {
+            return { state: 'valid', value: parseIntent(parsed), digest: rawDigest, rawBytes, rawDigest };
+        }
+        catch {
+            return { state: 'invalid', code: 'pluginIntentStateInvalid', digest: rawDigest, rawBytes, rawDigest };
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError')
+            throw error;
+        return invalidPath(error)
+            ? { state: 'invalid', code: 'pluginIntentStateInvalid' }
+            : { state: 'unreadable', code: 'pluginIntentStateUnavailable' };
+    }
+}
+async function mutateIntent(location, update) {
+    return withAwHomeMutationLock({ env: location.env, token: location.token, action: async () => {
+            const observation = await observeIntent(location);
+            if (observation.state !== 'absent' && observation.state !== 'valid') {
+                const diagnostic = describeStrongStateProblem({
+                    kind: 'intent', scope: location.scope, state: observation.state,
+                    filePath: await resolveIntentPath(location),
+                });
+                throw new Error(`${diagnostic.code}: ${diagnostic.message}`);
+            }
+            const current = observation.state === 'valid' ? observation.value : createEmptyIntent();
+            const next = parseIntent(update(current));
+            if (calculateIntentDigest(next) === calculateIntentDigest(current)) {
+                return { value: current, changed: false };
+            }
+            const { allowedRoot, filePath } = await intentPath(location, 'write');
+            const visibility = location.scope === 'project'
+                ? await assertProjectSharedConfigPathVisible({ cwd: allowedRoot, targetPath: filePath, env: location.env })
+                : undefined;
+            await atomicReplaceConfigFile({ filePath, allowedRoot, content: serializeIntent(next) });
+            return { value: next, changed: true, ...(visibility ? { visibility } : {}) };
+        } });
+}
+export function writeIntent(location, value) {
+    return mutateIntent(location, () => value);
+}
+export function addRoot(location, pluginId, logicalIdentity) {
+    return mutateIntent(location, (current) => addIntentRoot(current, pluginId, logicalIdentity));
+}
+export function removeRoot(location, pluginId) {
+    return mutateIntent(location, (current) => removeIntentRoot(current, pluginId));
+}
+//# sourceMappingURL=intent-store.js.map

package/dist/src/intent/intent-store.js.map

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

package/dist/src/intent/scope-context.d.ts

@@ -0,0 +1,33 @@
+import type { Scope } from '../types.js';
+export interface ScopeContext {
+    scope: Scope;
+    callerCwd: string;
+    executionCwd: string;
+    projectRoot?: string;
+    projectKey?: string;
+    configProfile: 'user' | 'project';
+    generationRoot: string;
+    awHome: string;
+    targetHomes: {
+        home: string;
+        codex: string;
+        claude: string;
+        cursor: string;
+        xdgState: string;
+    };
+    env: NodeJS.ProcessEnv;
+    dispose(): Promise<void>;
+}
+export interface ScopeContextOptions {
+    scope: Scope;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    readOnly?: boolean;
+}
+export declare function assertNeutralAncestorChain(candidate: string): Promise<string>;
+export declare function createSafeNeutralCwd(env: NodeJS.ProcessEnv): Promise<{
+    executionCwd: string;
+    dispose(): Promise<void>;
+}>;
+export declare function createScopeContext(options: ScopeContextOptions): Promise<ScopeContext>;
+export declare function withScopeContext<T>(options: ScopeContextOptions, action: (context: ScopeContext) => Promise<T>): Promise<T>;