@ai-pip/core 0.1.7 → 0.2.0

package/dist/isl/value-objects/RiskScore.js

@@ -0,0 +1,85 @@
+/**
+ * RiskScore - Value Object
+ *
+ * @remarks
+ * Represents a normalized risk value produced by the core semantic layers.
+ *
+ * - Value range is **0.0 to 1.0**
+ * - `0`   = no risk detected
+ * - `1`   = maximum risk confidence
+ *
+ * Although this type aliases `number`, it is intentionally defined
+ * as a value object to preserve **semantic meaning**, enforce conceptual clarity,
+ * and stabilize public contracts across layers and SDKs.
+ *
+ * This type MUST NOT be interpreted as a decision signal.
+ * Decisions based on RiskScore belong to higher layers (AAL / SDK).
+ */
+/**
+ * Minimum valid risk score value
+ */
+export const MIN_RISK_SCORE = 0;
+/**
+ * Maximum valid risk score value
+ */
+export const MAX_RISK_SCORE = 1;
+/**
+ * Creates a valid RiskScore value
+ *
+ * @param value - Numeric value to validate and normalize
+ * @returns Validated RiskScore
+ * @throws {Error} If value is outside valid range [0.0, 1.0]
+ */
+export function createRiskScore(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new TypeError('RiskScore must be a finite number');
+    }
+    if (value < MIN_RISK_SCORE || value > MAX_RISK_SCORE) {
+        throw new Error(`RiskScore must be between ${MIN_RISK_SCORE} and ${MAX_RISK_SCORE}, got ${value}`);
+    }
+    return value;
+}
+/**
+ * Normalizes a risk score to the valid range [0.0, 1.0]
+ *
+ * @param value - Numeric value to normalize
+ * @returns Normalized RiskScore clamped to [0.0, 1.0]
+ */
+export function normalizeRiskScore(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return MIN_RISK_SCORE;
+    }
+    return Math.max(MIN_RISK_SCORE, Math.min(MAX_RISK_SCORE, value));
+}
+/**
+ * Checks if a risk score is considered high
+ *
+ * @param score - RiskScore to evaluate
+ * @param threshold - Threshold for high risk (default: 0.7)
+ * @returns true if score >= threshold
+ */
+export function isHighRiskScore(score, threshold = 0.7) {
+    return score >= threshold;
+}
+/**
+ * Checks if a risk score is considered medium
+ *
+ * @param score - RiskScore to evaluate
+ * @param lowThreshold - Lower threshold (default: 0.3)
+ * @param highThreshold - Upper threshold (default: 0.7)
+ * @returns true if score is in medium range
+ */
+export function isMediumRiskScore(score, lowThreshold = 0.3, highThreshold = 0.7) {
+    return score >= lowThreshold && score < highThreshold;
+}
+/**
+ * Checks if a risk score is considered low
+ *
+ * @param score - RiskScore to evaluate
+ * @param threshold - Threshold for low risk (default: 0.3)
+ * @returns true if score < threshold
+ */
+export function isLowRiskScore(score, threshold = 0.3) {
+    return score < threshold;
+}
+//# sourceMappingURL=RiskScore.js.map

package/dist/isl/value-objects/RiskScore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RiskScore.js","sourceRoot":"","sources":["../../../src/isl/value-objects/RiskScore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc,CAAC,CAAA;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc,CAAC,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAA;IAC1D,CAAC;IAED,IAAI,KAAK,GAAG,cAAc,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,6BAA6B,cAAc,QAAQ,cAAc,SAAS,KAAK,EAAE,CAClF,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,YAAoB,GAAG;IACvE,OAAO,KAAK,IAAI,SAAS,CAAA;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAgB,EAChB,eAAuB,GAAG,EAC1B,gBAAwB,GAAG;IAE3B,OAAO,KAAK,IAAI,YAAY,IAAI,KAAK,GAAG,aAAa,CAAA;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,YAAoB,GAAG;IACtE,OAAO,KAAK,GAAG,SAAS,CAAA;AAC1B,CAAC"}

package/dist/isl/value-objects/index.d.ts

@@ -1,9 +1,9 @@
 export type { PiDetection } from './PiDetection.js';
 export type { PiDetectionResult } from './PiDetectionResult.js';
-export type { AnomalyScore } from './AnomalyScore.js';
 export type { Pattern } from './Pattern.js';
+export type { RiskScore } from './RiskScore.js';
 export { createPiDetection, getDetectionLength, isHighConfidence, isMediumConfidence, isLowConfidence } from './PiDetection.js';
 export { createPiDetectionResult, hasDetections, getDetectionCount, getDetectionsByType, getHighestConfidenceDetection } from './PiDetectionResult.js';
-export { createAnomalyScore, isHighRisk, isWarnRisk, isLowRisk } from './AnomalyScore.js';
 export { createPattern, matchesPattern, findMatch, MAX_CONTENT_LENGTH, MAX_PATTERN_LENGTH, MAX_MATCHES } from './Pattern.js';
+export { createRiskScore, normalizeRiskScore, isHighRiskScore, isMediumRiskScore, isLowRiskScore, MIN_RISK_SCORE, MAX_RISK_SCORE } from './RiskScore.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/isl/value-objects/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/isl/value-objects/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,SAAS,EACV,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACZ,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/isl/value-objects/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,wBAAwB,CAAA;AAI/B,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACZ,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACf,MAAM,gBAAgB,CAAA"}

package/dist/isl/value-objects/index.js

@@ -1,8 +1,6 @@
 // Funciones de creación
 export { createPiDetection, getDetectionLength, isHighConfidence, isMediumConfidence, isLowConfidence } from './PiDetection.js';
 export { createPiDetectionResult, hasDetections, getDetectionCount, getDetectionsByType, getHighestConfidenceDetection } from './PiDetectionResult.js';
-export { createAnomalyScore, isHighRisk, isWarnRisk, isLowRisk } from './AnomalyScore.js';
 export { createPattern, matchesPattern, findMatch, MAX_CONTENT_LENGTH, MAX_PATTERN_LENGTH, MAX_MATCHES } from './Pattern.js';
-// PolicyRule NO es core - va a ModelGateway/Policy Engine
-// Se mantiene el tipo para compatibilidad pero las funciones de decisión no son core
+export { createRiskScore, normalizeRiskScore, isHighRiskScore, isMediumRiskScore, isLowRiskScore, MIN_RISK_SCORE, MAX_RISK_SCORE } from './RiskScore.js';
 //# sourceMappingURL=index.js.map

package/dist/isl/value-objects/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/isl/value-objects/index.ts"],"names":[],"mappings":"AAKA,wBAAwB;AACxB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,SAAS,EACV,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACZ,MAAM,cAAc,CAAA;AAErB,0DAA0D;AAC1D,qFAAqF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/isl/value-objects/index.ts"],"names":[],"mappings":"AAKA,wBAAwB;AACxB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,wBAAwB,CAAA;AAI/B,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACZ,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACf,MAAM,gBAAgB,CAAA"}

package/dist/shared/audit.d.ts

@@ -0,0 +1,150 @@
+/**
+ * AI-PIP Audit utilities - Pure functions for ordered, human-readable audit output
+ *
+ * @remarks
+ * These functions format layer results and signals into consistent, pretty-printed
+ * strings or structured data for auditing, logging, and compliance. They are
+ * layer-agnostic (accept minimal shapes) and do not depend on layer internals.
+ */
+/** Lineage entry shape used across layers */
+export interface LineageEntryLike {
+    readonly step: string;
+    readonly timestamp: number;
+}
+/** CSL result shape for audit formatting */
+export interface CSLResultLike {
+    readonly segments: ReadonlyArray<{
+        readonly id: string;
+        readonly content: string;
+        readonly trust: {
+            readonly value: string;
+        };
+        readonly lineage?: readonly LineageEntryLike[];
+    }>;
+    readonly lineage: readonly LineageEntryLike[];
+    readonly processingTimeMs?: number;
+}
+/** ISL result shape for audit formatting */
+export interface ISLResultLike {
+    readonly segments: ReadonlyArray<{
+        readonly id: string;
+        readonly originalContent: string;
+        readonly sanitizedContent: string;
+        readonly trust: {
+            readonly value: string;
+        };
+        readonly sanitizationLevel: string;
+        readonly lineage?: readonly LineageEntryLike[];
+    }>;
+    readonly lineage: readonly LineageEntryLike[];
+    readonly metadata: {
+        readonly totalSegments: number;
+        readonly sanitizedSegments: number;
+        readonly processingTimeMs?: number;
+    };
+}
+/** ISL signal shape for audit formatting */
+export interface ISLSignalLike {
+    readonly riskScore: number;
+    readonly hasThreats: boolean;
+    readonly timestamp: number;
+    readonly piDetection: {
+        readonly detected: boolean;
+        readonly score: number;
+        readonly detections: ReadonlyArray<unknown>;
+        readonly patterns?: readonly string[];
+    };
+}
+/** AAL decision reason shape for audit formatting */
+export interface DecisionReasonLike {
+    readonly action: string;
+    readonly reason: string;
+    readonly riskScore: number;
+    readonly threshold: number;
+    readonly hasThreats: boolean;
+    readonly detectionCount: number;
+}
+/** AAL removal plan shape for audit formatting */
+export interface RemovalPlanLike {
+    readonly shouldRemove: boolean;
+    readonly removalEnabled: boolean;
+    readonly instructionsToRemove: ReadonlyArray<{
+        readonly type?: string;
+        readonly pattern?: string;
+        readonly description?: string;
+    }>;
+}
+/** CPE result shape for audit formatting */
+export interface CPEResultLike {
+    readonly envelope: {
+        readonly metadata: {
+            readonly timestamp: number;
+            readonly nonce: string;
+            readonly protocolVersion?: string;
+        };
+        readonly signature: {
+            readonly algorithm: string;
+            readonly value?: string;
+        };
+        readonly lineage: readonly LineageEntryLike[];
+    };
+    readonly processingTimeMs?: number;
+}
+/**
+ * Formats lineage entries for pretty audit output
+ *
+ * @param lineage - Array of lineage entries (any layer)
+ * @returns Formatted string
+ */
+export declare function formatLineageForAudit(lineage: readonly LineageEntryLike[]): string;
+/**
+ * Formats CSL result for audit - ordered and human-readable
+ *
+ * @param result - CSL result (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export declare function formatCSLForAudit(result: CSLResultLike): string;
+/**
+ * Formats ISL result for audit - ordered and human-readable
+ *
+ * @param result - ISL result (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export declare function formatISLForAudit(result: ISLResultLike): string;
+/**
+ * Formats ISL signal for audit - ordered and human-readable
+ *
+ * @param signal - ISL signal (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export declare function formatISLSignalForAudit(signal: ISLSignalLike): string;
+/**
+ * Formats AAL decision reason and optional removal plan for audit
+ *
+ * @param reason - Decision reason (or compatible shape)
+ * @param removalPlan - Optional removal plan (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export declare function formatAALForAudit(reason: DecisionReasonLike, removalPlan?: RemovalPlanLike | null): string;
+/**
+ * Formats CPE result for audit - ordered and human-readable
+ *
+ * @param result - CPE result (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export declare function formatCPEForAudit(result: CPEResultLike): string;
+/**
+ * Builds a full pipeline audit report (CSL → ISL → CPE) from layer results.
+ * Accepts minimal shapes for flexibility.
+ *
+ * @param csl - CSL result (or compatible shape)
+ * @param isl - ISL result (or compatible shape)
+ * @param cpe - CPE result (or compatible shape)
+ * @param options - Optional title and separator
+ * @returns Single formatted string for full audit
+ */
+export declare function formatPipelineAudit(csl: CSLResultLike, isl: ISLResultLike, cpe: CPEResultLike, options?: {
+    title?: string;
+    sectionSeparator?: string;
+}): string;
+//# sourceMappingURL=audit.d.ts.map

package/dist/shared/audit.d.ts.map

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

package/dist/shared/audit.js

@@ -0,0 +1,173 @@
+/**
+ * AI-PIP Audit utilities - Pure functions for ordered, human-readable audit output
+ *
+ * @remarks
+ * These functions format layer results and signals into consistent, pretty-printed
+ * strings or structured data for auditing, logging, and compliance. They are
+ * layer-agnostic (accept minimal shapes) and do not depend on layer internals.
+ */
+const SEP = '  ';
+const BORDER = '---';
+/**
+ * Formats lineage entries for pretty audit output
+ *
+ * @param lineage - Array of lineage entries (any layer)
+ * @returns Formatted string
+ */
+export function formatLineageForAudit(lineage) {
+    if (lineage.length === 0)
+        return 'Lineage: (none)';
+    const lines = lineage.map((e, i) => `${SEP}${i + 1}. [${e.step}] ${new Date(e.timestamp).toISOString()}`);
+    return ['Lineage:', ...lines].join('\n');
+}
+/**
+ * Formats CSL result for audit - ordered and human-readable
+ *
+ * @param result - CSL result (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export function formatCSLForAudit(result) {
+    const processingTimeLine = typeof result.processingTimeMs === 'number'
+        ? [`Processing time: ${result.processingTimeMs}ms`]
+        : [];
+    const segmentLines = result.segments.map((seg, i) => `${SEP}Segment ${i + 1}: id=${seg.id} trust=${seg.trust.value} content_length=${seg.content.length}`);
+    const lines = [
+        '[CSL] Context Segmentation Layer',
+        BORDER,
+        `Segments: ${result.segments.length}`,
+        ...processingTimeLine,
+        ...segmentLines,
+        '',
+        formatLineageForAudit(result.lineage)
+    ];
+    return lines.join('\n');
+}
+/**
+ * Formats ISL result for audit - ordered and human-readable
+ *
+ * @param result - ISL result (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export function formatISLForAudit(result) {
+    const meta = result.metadata;
+    const processingTimeLine = typeof meta.processingTimeMs === 'number' ? [`Processing time: ${meta.processingTimeMs}ms`] : [];
+    const segmentLines = result.segments.flatMap((seg, i) => [
+        `${SEP}Segment ${i + 1}: id=${seg.id} trust=${seg.trust.value} level=${seg.sanitizationLevel}`,
+        `${SEP}  original_length=${seg.originalContent.length} sanitized_length=${seg.sanitizedContent.length}`
+    ]);
+    const lines = [
+        '[ISL] Instruction Sanitization Layer',
+        BORDER,
+        `Segments: ${meta.totalSegments} (sanitized: ${meta.sanitizedSegments})`,
+        ...processingTimeLine,
+        ...segmentLines,
+        '',
+        formatLineageForAudit(result.lineage)
+    ];
+    return lines.join('\n');
+}
+/**
+ * Formats ISL signal for audit - ordered and human-readable
+ *
+ * @param signal - ISL signal (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export function formatISLSignalForAudit(signal) {
+    const pd = signal.piDetection;
+    const patternLine = pd.patterns && pd.patterns.length > 0 ? [`${SEP}Patterns: ${pd.patterns.join(', ')}`] : [];
+    const lines = [
+        '[ISL Signal] External contract',
+        BORDER,
+        `Risk score: ${signal.riskScore.toFixed(3)}`,
+        `Has threats: ${signal.hasThreats}`,
+        `Timestamp: ${new Date(signal.timestamp).toISOString()}`,
+        `Detections: ${pd.detections.length} (score: ${pd.score.toFixed(3)}, detected: ${pd.detected})`,
+        ...patternLine
+    ];
+    return lines.join('\n');
+}
+/**
+ * Formats AAL decision reason and optional removal plan for audit
+ *
+ * @param reason - Decision reason (or compatible shape)
+ * @param removalPlan - Optional removal plan (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export function formatAALForAudit(reason, removalPlan) {
+    const plan = removalPlan ?? undefined;
+    const removalBlock = plan === undefined
+        ? []
+        : [
+            '',
+            `Removal enabled: ${plan.removalEnabled}`,
+            `Should remove: ${plan.shouldRemove}`,
+            ...(plan.instructionsToRemove.length > 0
+                ? [
+                    `Instructions to remove: ${plan.instructionsToRemove.length}`,
+                    ...plan.instructionsToRemove.map((inst, i) => `${SEP}${i + 1}. ${inst.type ?? 'unknown'} - ${inst.description ?? inst.pattern ?? ''}`)
+                ]
+                : [])
+        ];
+    const lines = [
+        '[AAL] Agent Action Lock',
+        BORDER,
+        `Action: ${reason.action}`,
+        `Risk score: ${reason.riskScore.toFixed(3)} (threshold: ${reason.threshold.toFixed(3)})`,
+        `Reason: ${reason.reason}`,
+        `Threats: ${reason.hasThreats} (count: ${reason.detectionCount})`,
+        ...removalBlock
+    ];
+    return lines.join('\n');
+}
+/**
+ * Formats CPE result for audit - ordered and human-readable
+ *
+ * @param result - CPE result (or compatible shape)
+ * @returns Formatted string for auditing
+ */
+export function formatCPEForAudit(result) {
+    const env = result.envelope;
+    const protocolVersionLine = typeof env.metadata.protocolVersion === 'string'
+        ? [`Protocol version: ${env.metadata.protocolVersion}`]
+        : [];
+    const processingTimeLine = typeof result.processingTimeMs === 'number'
+        ? [`Processing time: ${result.processingTimeMs}ms`]
+        : [];
+    const lines = [
+        '[CPE] Cryptographic Prompt Envelope',
+        BORDER,
+        `Nonce: ${env.metadata.nonce}`,
+        `Timestamp: ${new Date(env.metadata.timestamp).toISOString()}`,
+        ...protocolVersionLine,
+        `Signature algorithm: ${env.signature.algorithm}`,
+        ...processingTimeLine,
+        '',
+        formatLineageForAudit(env.lineage)
+    ];
+    return lines.join('\n');
+}
+/**
+ * Builds a full pipeline audit report (CSL → ISL → CPE) from layer results.
+ * Accepts minimal shapes for flexibility.
+ *
+ * @param csl - CSL result (or compatible shape)
+ * @param isl - ISL result (or compatible shape)
+ * @param cpe - CPE result (or compatible shape)
+ * @param options - Optional title and separator
+ * @returns Single formatted string for full audit
+ */
+export function formatPipelineAudit(csl, isl, cpe, options) {
+    const sep = options?.sectionSeparator ?? '\n\n';
+    const title = options?.title ?? 'AI-PIP Pipeline Audit';
+    const parts = [
+        title,
+        BORDER,
+        formatCSLForAudit(csl),
+        sep,
+        formatISLForAudit(isl),
+        sep,
+        formatCPEForAudit(cpe)
+    ];
+    return parts.join('\n');
+}
+//# sourceMappingURL=audit.js.map

package/dist/shared/audit.js.map

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

package/dist/shared/index.d.ts

@@ -1,9 +1,11 @@
 /**
- * Shared utilities for all layers - funciones puras compartidas
+ * Shared utilities for all layers - pure functions shared across the core
  *
  * @remarks
- * Solo funciones básicas de manejo de linaje.
- * Auditoría y análisis avanzado van al SDK.
+ * Lineage handling and AI-PIP audit formatting for clear, flexible auditing.
  */
 export { addLineageEntry, addLineageEntries, filterLineageByStep, getLastLineageEntry } from './lineage.js';
+export { formatLineageForAudit, formatCSLForAudit, formatISLForAudit, formatISLSignalForAudit, formatAALForAudit, formatCPEForAudit, formatPipelineAudit } from './audit.js';
+export type { LineageEntryLike, CSLResultLike, ISLResultLike, ISLSignalLike, DecisionReasonLike, RemovalPlanLike, CPEResultLike } from './audit.js';
+export type { Position, SegmentRef } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,QAAQ,EACR,UAAU,EACX,MAAM,YAAY,CAAA"}

package/dist/shared/index.js

@@ -1,12 +1,11 @@
 /**
- * Shared utilities for all layers - funciones puras compartidas
+ * Shared utilities for all layers - pure functions shared across the core
  *
  * @remarks
- * Solo funciones básicas de manejo de linaje.
- * Auditoría y análisis avanzado van al SDK.
+ * Lineage handling and AI-PIP audit formatting for clear, flexible auditing.
  */
-// Lineage básico
+// Lineage
 export { addLineageEntry, addLineageEntries, filterLineageByStep, getLastLineageEntry } from './lineage.js';
-// Funciones de auditoría NO son core - van al SDK/tooling
-// El core solo preserva linaje, no lo analiza
+// Audit / pretty-print for AI-PIP layers (ordered, human-readable)
+export { formatLineageForAudit, formatCSLForAudit, formatISLForAudit, formatISLSignalForAudit, formatAALForAudit, formatCPEForAudit, formatPipelineAudit } from './audit.js';
 //# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,cAAc,CAAA;AAErB,0DAA0D;AAC1D,8CAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,UAAU;AACV,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,cAAc,CAAA;AAErB,mEAAmE;AACnE,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,YAAY,CAAA"}

package/dist/shared/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Represents a zero-based position range within a string or segment.
+ *
+ * @remarks
+ * - `start` is inclusive
+ * - `end` is exclusive
+ * - Must satisfy: 0 <= start <= end
+ *
+ * This type is purely structural and shared across layers
+ * (CSL, ISL, AAL, reporters).
+ */
+export type Position = {
+    /** Inclusive start index */
+    readonly start: number;
+    /** Exclusive end index */
+    readonly end: number;
+};
+/**
+ * References a specific segment and an optional position within it.
+ *
+ * @remarks
+ * Used to precisely point to a sub-range of a segment without
+ * mutating or interpreting its content.
+ *
+ * Common use cases:
+ * - ISL: attach threat signals to exact locations
+ * - AAL: target removals or locks precisely
+ * - Reporting: highlight affected content
+ */
+export type SegmentRef = {
+    /** Unique identifier of the segment */
+    readonly segmentId: string;
+    /** Optional position within the segment */
+    readonly position?: Position;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG;IACnB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC7B,CAAA"}

package/dist/shared/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-pip/core",
-  "version": "0.1.7",
-  "description": "Core implementation of the AI-PIP protocol. Provides layered, zero-trust context processing (CSL, ISL, CPE, ALL, ModelGateway)",
+  "version": "0.2.0",
+  "description": "Core implementation of the AI-PIP protocol. Provides layered, zero-trust context processing (CSL, ISL, AAL, CPE)",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,6 +21,11 @@
       "import": "./dist/isl/index.js",
       "default": "./dist/isl/index.js"
     },
+    "./aal": {
+      "types": "./dist/AAL/index.d.ts",
+      "import": "./dist/AAL/index.js",
+      "default": "./dist/AAL/index.js"
+    },
     "./cpe": {
       "types": "./dist/cpe/index.d.ts",
       "import": "./dist/cpe/index.js",

package/dist/isl/value-objects/AnomalyScore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AnomalyScore.d.ts","sourceRoot":"","sources":["../../../src/isl/value-objects/AnomalyScore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE3D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B,CAAA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,YAAY,CAUxF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAEzD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAEzD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAExD"}