apcore-js 0.24.1 → 0.26.0

package/dist/policy.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Execution-time governance policy: external overrides for governance annotations.
+ *
+ * RFC pilot for apcore#76 ("first-class external governance / policy API").
+ * An {@link ExecutionPolicy} lets a platform operator override the governance
+ * annotations (`requiresApproval`, `destructive`) of already-registered modules
+ * at execution time, independent of how the modules were registered. It attaches
+ * to the {@link Executor} (`policy` option) and is consulted by the approval
+ * gate (Step 5).
+ *
+ * Precedence: a matched policy rule overrides the module's own declared or
+ * scanned annotations — external governance is the platform's word against the
+ * module author's. Matching uses the same wildcard semantics as the ACL system
+ * (Algorithm A08) and the same specificity scoring (Algorithm A10); on a
+ * specificity tie the more restrictive rule wins.
+ *
+ * Governance principle (apcore#76): a misconfigured or unreachable governance
+ * control must warn or error, never silently allow. {@link ExecutionPolicy.fromObject}
+ * therefore rejects unknown keys (a typo in a governance file must not silently
+ * no-op), and `strict=true` makes the approval gate fail closed when approval is
+ * required but no ApprovalHandler is configured.
+ */
+import type { ModuleAnnotations } from './module.js';
+/** Overrides accepted by the {@link PolicyRule} constructor. */
+export interface PolicyRuleOverrides {
+    /**
+     * Override for the module's `requiresApproval` annotation. `null`/`undefined`
+     * leaves the module's own value in effect.
+     */
+    requiresApproval?: boolean | null;
+    /**
+     * Override for the module's `destructive` annotation. `null`/`undefined`
+     * leaves the module's own value in effect.
+     */
+    destructive?: boolean | null;
+    /** Human-readable rationale, carried into the audit trail. */
+    reason?: string | null;
+}
+/**
+ * A single pattern-based governance override (apcore#76 RFC pilot).
+ *
+ * Immutable; validates its fields eagerly so a malformed governance rule fails
+ * loud at construction rather than silently no-op'ing at execution time.
+ */
+export declare class PolicyRule {
+    /**
+     * Module ID wildcard pattern (Algorithm A08 semantics, same as ACL rules).
+     * `*` matches any character sequence including dots.
+     */
+    readonly pattern: string;
+    readonly requiresApproval: boolean | null;
+    readonly destructive: boolean | null;
+    readonly reason: string | null;
+    constructor(pattern: string, overrides?: PolicyRuleOverrides);
+}
+/**
+ * The effective governance verdict for one module under a policy.
+ *
+ * - `requiresApproval` / `destructive`: effective values after overrides.
+ * - `needsApproval`: final approval-gate verdict — true when the effective
+ *   `requiresApproval` is true, or when the policy gates destructive modules
+ *   and the effective `destructive` is true.
+ * - `rule`: the matched {@link PolicyRule}, or `null` when no rule matched.
+ * - `overridden`: true when the matched rule changed a base annotation value.
+ */
+export interface PolicyDecision {
+    readonly moduleId: string;
+    readonly requiresApproval: boolean;
+    readonly destructive: boolean;
+    readonly needsApproval: boolean;
+    readonly rule: PolicyRule | null;
+    readonly overridden: boolean;
+}
+/**
+ * Declarative execution-time governance overrides (apcore#76 RFC pilot).
+ *
+ * @example
+ * ```ts
+ * const policy = new ExecutionPolicy(
+ *   [new PolicyRule('orders.delete_*', { requiresApproval: true, reason: 'human sign-off' })],
+ *   { gateDestructive: true, strict: true },
+ * );
+ * const executor = new Executor({ registry, approvalHandler: handler, policy });
+ * ```
+ */
+export declare class ExecutionPolicy {
+    private readonly _rules;
+    /**
+     * When true, modules whose effective `destructive` annotation is true require
+     * approval even if `requiresApproval` is false — the opt-in resolution of the
+     * destructive↔approval gap described in apcore#76.
+     */
+    readonly gateDestructive: boolean;
+    /**
+     * When true, the approval gate fails closed (denies) when a module needs
+     * approval but no ApprovalHandler is configured. When false (default), the
+     * gate keeps the PROTOCOL_SPEC §7.4 skip behavior but logs a warning.
+     */
+    readonly strict: boolean;
+    constructor(rules?: PolicyRule[] | null, options?: {
+        gateDestructive?: boolean;
+        strict?: boolean;
+    });
+    /** The policy's rules as an immutable array. */
+    get rules(): readonly PolicyRule[];
+    /**
+     * Compute the effective governance decision for a module.
+     *
+     * @param moduleId - Canonical module ID being invoked.
+     * @param annotations - The module's annotations (ModuleAnnotations, dict, or
+     *   null). Only `requiresApproval`/`requires_approval` and `destructive` are
+     *   consulted.
+     */
+    resolve(moduleId: string, annotations?: unknown): PolicyDecision;
+    /** Return the winning rule for a module ID, or null. */
+    private _match;
+    /**
+     * Build a policy from a plain object (parsed YAML/JSON governance file).
+     *
+     * Parsing is strict: unknown keys throw so a typo in a governance file fails
+     * loud instead of silently disabling a control.
+     *
+     * Expected shape:
+     * ```yaml
+     * gate_destructive: true
+     * strict: true
+     * rules:
+     *   - pattern: "orders.delete_*"
+     *     requires_approval: true
+     *     reason: "destructive order operations need human sign-off"
+     * ```
+     *
+     * @throws {Error} On unknown keys, missing `pattern`, or wrong types.
+     */
+    static fromObject(data: unknown): ExecutionPolicy;
+}
+/**
+ * Build effective ModuleAnnotations for an ApprovalRequest under a policy
+ * decision, preserving the PROTOCOL_SPEC §7 "requiresApproval is guaranteed
+ * true" contract: the handler sees the effective governance values, not the
+ * module's raw declaration.
+ */
+export declare function applyDecisionToAnnotations(annotations: ModuleAnnotations, decision: PolicyDecision): ModuleAnnotations;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMrD,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACrB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,mBAAwB;CAwBjE;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAkBD;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAGvB,KAAK,GAAE,UAAU,EAAE,GAAG,IAAW,EACjC,OAAO,GAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO;IAa/D,gDAAgD;IAChD,IAAI,KAAK,IAAI,SAAS,UAAU,EAAE,CAEjC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,OAAc,GAAG,cAAc;IA4BtE,wDAAwD;IACxD,OAAO,CAAC,MAAM;IAoBd;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe;CAiDlD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,iBAAiB,EAC9B,QAAQ,EAAE,cAAc,GACvB,iBAAiB,CAMnB"}

package/dist/policy.js

@@ -0,0 +1,242 @@
+/**
+ * Execution-time governance policy: external overrides for governance annotations.
+ *
+ * RFC pilot for apcore#76 ("first-class external governance / policy API").
+ * An {@link ExecutionPolicy} lets a platform operator override the governance
+ * annotations (`requiresApproval`, `destructive`) of already-registered modules
+ * at execution time, independent of how the modules were registered. It attaches
+ * to the {@link Executor} (`policy` option) and is consulted by the approval
+ * gate (Step 5).
+ *
+ * Precedence: a matched policy rule overrides the module's own declared or
+ * scanned annotations — external governance is the platform's word against the
+ * module author's. Matching uses the same wildcard semantics as the ACL system
+ * (Algorithm A08) and the same specificity scoring (Algorithm A10); on a
+ * specificity tie the more restrictive rule wins.
+ *
+ * Governance principle (apcore#76): a misconfigured or unreachable governance
+ * control must warn or error, never silently allow. {@link ExecutionPolicy.fromObject}
+ * therefore rejects unknown keys (a typo in a governance file must not silently
+ * no-op), and `strict=true` makes the approval gate fail closed when approval is
+ * required but no ApprovalHandler is configured.
+ */
+import { calculateSpecificity, matchPattern } from './utils/pattern.js';
+const POLICY_KEYS = new Set(['rules', 'gate_destructive', 'strict']);
+const RULE_KEYS = new Set(['pattern', 'requires_approval', 'destructive', 'reason']);
+/**
+ * A single pattern-based governance override (apcore#76 RFC pilot).
+ *
+ * Immutable; validates its fields eagerly so a malformed governance rule fails
+ * loud at construction rather than silently no-op'ing at execution time.
+ */
+export class PolicyRule {
+    /**
+     * Module ID wildcard pattern (Algorithm A08 semantics, same as ACL rules).
+     * `*` matches any character sequence including dots.
+     */
+    pattern;
+    requiresApproval;
+    destructive;
+    reason;
+    constructor(pattern, overrides = {}) {
+        if (typeof pattern !== 'string' || pattern.length === 0) {
+            throw new Error('PolicyRule.pattern must be a non-empty string');
+        }
+        const requiresApproval = overrides.requiresApproval ?? null;
+        const destructive = overrides.destructive ?? null;
+        const reason = overrides.reason ?? null;
+        for (const [name, value] of [
+            ['requiresApproval', requiresApproval],
+            ['destructive', destructive],
+        ]) {
+            if (value !== null && typeof value !== 'boolean') {
+                throw new Error(`PolicyRule.${name} must be a boolean or null, got ${typeof value}`);
+            }
+        }
+        if (reason !== null && typeof reason !== 'string') {
+            throw new Error(`PolicyRule.reason must be a string or null, got ${typeof reason}`);
+        }
+        this.pattern = pattern;
+        this.requiresApproval = requiresApproval;
+        this.destructive = destructive;
+        this.reason = reason;
+        Object.freeze(this);
+    }
+}
+/** Read a boolean annotation from a ModuleAnnotations object or a dict. */
+function readAnnotationBool(annotations, camelKey, snakeKey) {
+    if (annotations == null || typeof annotations !== 'object')
+        return false;
+    const obj = annotations;
+    if (camelKey in obj)
+        return Boolean(obj[camelKey]);
+    if (snakeKey in obj)
+        return Boolean(obj[snakeKey]);
+    return false;
+}
+/** Tie-break key: rules that force gating rank above rules that relax it. */
+function restrictiveness(rule) {
+    // (requiresApproval === true) outranks (destructive === true); encode as a
+    // 2-bit score so a lexicographic tuple comparison collapses to `>`.
+    return (rule.requiresApproval === true ? 2 : 0) + (rule.destructive === true ? 1 : 0);
+}
+/**
+ * Declarative execution-time governance overrides (apcore#76 RFC pilot).
+ *
+ * @example
+ * ```ts
+ * const policy = new ExecutionPolicy(
+ *   [new PolicyRule('orders.delete_*', { requiresApproval: true, reason: 'human sign-off' })],
+ *   { gateDestructive: true, strict: true },
+ * );
+ * const executor = new Executor({ registry, approvalHandler: handler, policy });
+ * ```
+ */
+export class ExecutionPolicy {
+    _rules;
+    /**
+     * When true, modules whose effective `destructive` annotation is true require
+     * approval even if `requiresApproval` is false — the opt-in resolution of the
+     * destructive↔approval gap described in apcore#76.
+     */
+    gateDestructive;
+    /**
+     * When true, the approval gate fails closed (denies) when a module needs
+     * approval but no ApprovalHandler is configured. When false (default), the
+     * gate keeps the PROTOCOL_SPEC §7.4 skip behavior but logs a warning.
+     */
+    strict;
+    constructor(rules = null, options = {}) {
+        const frozen = Object.freeze([...(rules ?? [])]);
+        for (const rule of frozen) {
+            if (!(rule instanceof PolicyRule)) {
+                throw new Error(`ExecutionPolicy rules must be PolicyRule instances, got ${typeof rule}`);
+            }
+        }
+        this._rules = frozen;
+        this.gateDestructive = Boolean(options.gateDestructive);
+        this.strict = Boolean(options.strict);
+    }
+    /** The policy's rules as an immutable array. */
+    get rules() {
+        return this._rules;
+    }
+    /**
+     * Compute the effective governance decision for a module.
+     *
+     * @param moduleId - Canonical module ID being invoked.
+     * @param annotations - The module's annotations (ModuleAnnotations, dict, or
+     *   null). Only `requiresApproval`/`requires_approval` and `destructive` are
+     *   consulted.
+     */
+    resolve(moduleId, annotations = null) {
+        const baseRequiresApproval = readAnnotationBool(annotations, 'requiresApproval', 'requires_approval');
+        const baseDestructive = readAnnotationBool(annotations, 'destructive', 'destructive');
+        const rule = this._match(moduleId);
+        const effectiveRequiresApproval = rule === null || rule.requiresApproval === null
+            ? baseRequiresApproval
+            : rule.requiresApproval;
+        const effectiveDestructive = rule === null || rule.destructive === null ? baseDestructive : rule.destructive;
+        return {
+            moduleId,
+            requiresApproval: effectiveRequiresApproval,
+            destructive: effectiveDestructive,
+            needsApproval: effectiveRequiresApproval || (this.gateDestructive && effectiveDestructive),
+            rule,
+            overridden: effectiveRequiresApproval !== baseRequiresApproval ||
+                effectiveDestructive !== baseDestructive,
+        };
+    }
+    /** Return the winning rule for a module ID, or null. */
+    _match(moduleId) {
+        let best = null;
+        let bestScore = -1;
+        for (const rule of this._rules) {
+            if (!matchPattern(rule.pattern, moduleId))
+                continue;
+            const score = calculateSpecificity(rule.pattern);
+            if (score > bestScore) {
+                best = rule;
+                bestScore = score;
+            }
+            else if (score === bestScore &&
+                best !== null &&
+                restrictiveness(rule) > restrictiveness(best)) {
+                best = rule;
+            }
+        }
+        return best;
+    }
+    /**
+     * Build a policy from a plain object (parsed YAML/JSON governance file).
+     *
+     * Parsing is strict: unknown keys throw so a typo in a governance file fails
+     * loud instead of silently disabling a control.
+     *
+     * Expected shape:
+     * ```yaml
+     * gate_destructive: true
+     * strict: true
+     * rules:
+     *   - pattern: "orders.delete_*"
+     *     requires_approval: true
+     *     reason: "destructive order operations need human sign-off"
+     * ```
+     *
+     * @throws {Error} On unknown keys, missing `pattern`, or wrong types.
+     */
+    static fromObject(data) {
+        if (data == null || typeof data !== 'object' || Array.isArray(data)) {
+            const kind = Array.isArray(data) ? 'array' : typeof data;
+            throw new Error(`Policy document must be a mapping, got ${kind}`);
+        }
+        const obj = data;
+        const unknown = Object.keys(obj).filter((k) => !POLICY_KEYS.has(k));
+        if (unknown.length > 0) {
+            throw new Error(`Unknown policy keys ${JSON.stringify(unknown.sort())}; a governance file must not silently no-op`);
+        }
+        const rulesRaw = obj['rules'] ?? [];
+        if (!Array.isArray(rulesRaw)) {
+            throw new Error(`Policy 'rules' must be a list, got ${typeof rulesRaw}`);
+        }
+        const rules = [];
+        rulesRaw.forEach((item, index) => {
+            if (item == null || typeof item !== 'object' || Array.isArray(item)) {
+                const kind = Array.isArray(item) ? 'array' : typeof item;
+                throw new Error(`Policy rule #${index} must be a mapping, got ${kind}`);
+            }
+            const ruleObj = item;
+            const unknownRule = Object.keys(ruleObj).filter((k) => !RULE_KEYS.has(k));
+            if (unknownRule.length > 0) {
+                throw new Error(`Policy rule #${index} has unknown keys ${JSON.stringify(unknownRule.sort())}; ` +
+                    'a governance rule must not silently no-op');
+            }
+            if (!('pattern' in ruleObj)) {
+                throw new Error(`Policy rule #${index} is missing required key 'pattern'`);
+            }
+            rules.push(new PolicyRule(ruleObj['pattern'], {
+                requiresApproval: (ruleObj['requires_approval'] ?? null),
+                destructive: (ruleObj['destructive'] ?? null),
+                reason: (ruleObj['reason'] ?? null),
+            }));
+        });
+        return new ExecutionPolicy(rules, {
+            gateDestructive: Boolean(obj['gate_destructive'] ?? false),
+            strict: Boolean(obj['strict'] ?? false),
+        });
+    }
+}
+/**
+ * Build effective ModuleAnnotations for an ApprovalRequest under a policy
+ * decision, preserving the PROTOCOL_SPEC §7 "requiresApproval is guaranteed
+ * true" contract: the handler sees the effective governance values, not the
+ * module's raw declaration.
+ */
+export function applyDecisionToAnnotations(annotations, decision) {
+    return Object.freeze({
+        ...annotations,
+        requiresApproval: true,
+        destructive: decision.destructive,
+    });
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apcore-js",
-  "version": "0.24.1",
+  "version": "0.26.0",
   "description": "Schema-driven module standard for AI-perceivable interfaces",
   "type": "module",
   "main": "./dist/index.js",