@deftai/directive-core 0.55.0

package/dist/architecture/sor-preflight.d.ts

@@ -0,0 +1,66 @@
+/**
+ * architecture/sor-preflight.ts -- System-of-record architecture preflight gate.
+ *
+ * Faithful TypeScript port of scripts/preflight_architecture_sor.py and
+ * scripts/_sor_gate_diff.py. Answers one question:
+ *   "Is this the correct system of record for this kind of state?"
+ *
+ * Two modes:
+ * - Story/spec mode: validates the story's architecture.systemOfRecord design record.
+ * - Diff mode: scans changed runtime code for risky persistence signals and requires
+ *   a matching design record.
+ *
+ * Exit codes: 0 pass / 1 architecture violation / 2 gate misconfigured
+ */
+export declare const STATE_CLASSIFICATIONS: Set<string>;
+export declare const DURABLE_CLASSIFICATIONS: Set<string>;
+export declare const SECURITY_CLASSIFICATIONS: Set<string>;
+export declare const LOCAL_STORAGE_CLASSES: Set<string>;
+export declare const FILE_STORAGE_CLASSES: Set<string>;
+export declare const DB_STORAGE_ALIASES: Set<string>;
+export declare const EXTERNAL_STORAGE_ALIASES: Set<string>;
+export declare const DURABLE_REQUIRED_FIELDS: string[];
+export declare const LOW_RISK_PATH_PREFIXES: readonly string[];
+export declare const LOW_RISK_SUFFIXES: Set<string>;
+export declare const SCANNER_EXEMPT_PATHS: Set<string>;
+export interface GateFinding {
+    reason: string;
+    requiredFix: string;
+    stateSurface?: string;
+    classification?: string;
+    detectedStorage?: string;
+    approvedStorage?: string;
+}
+export interface GateResult {
+    code: number;
+    message: string;
+    findings: readonly GateFinding[];
+}
+export interface DetectedSignal {
+    kind: string;
+    path: string;
+    line: number | null;
+    detail: string;
+    storage?: string;
+}
+type JsonObj = Record<string, unknown>;
+export declare function norm(value: unknown): string;
+export declare function storageMatches(storage: string, declared: unknown): boolean;
+export declare function systemOfRecord(payload: JsonObj): JsonObj | null;
+export declare function validateRecord(record: JsonObj | null, opts?: {
+    storyPayload?: JsonObj | null;
+    signals?: DetectedSignal[];
+}): GateResult;
+export declare function scanDiff(diffText: string): [DetectedSignal[], string[]];
+export declare function evaluateDiffText(diffText: string, opts: {
+    projectRoot: string;
+    storyPath?: string;
+}): GateResult;
+export declare function evaluateDiff(projectRoot: string, baseRef: string, opts?: {
+    storyPath?: string;
+}): GateResult;
+export declare function evaluateStory(storyPath: string): GateResult;
+/** CLI entry for architecture-preflight-sor (mirrors preflight_architecture_sor.py main()). */
+export declare function architecturePreflightSorMain(argv: string[]): number;
+export {};
+//# sourceMappingURL=sor-preflight.d.ts.map