@unifyplane/logsdk 0.1.0

package/dist/validate/api_surface_guard.js

@@ -0,0 +1,63 @@
+import { API_SURFACE_VIOLATION, NonComplianceError, } from "./noncompliance.js";
+const ALLOWED_SCOPES = ["request", "job", "component"];
+const FORBIDDEN_NAMES = new Set([
+    "withContext",
+    "ctx",
+    "meta",
+    "attributes",
+    "tags",
+    "labels",
+    "log",
+    "emit",
+    "metric",
+    "span",
+]);
+function assertFunction(value, name, arity) {
+    if (typeof value !== "function") {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, `${name} must be a function.`);
+    }
+    if (value.length !== arity) {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, `${name} must accept exactly ${arity} argument(s).`);
+    }
+}
+function assertChildScopePolicy(child) {
+    const candidate = child;
+    const allowedScopes = candidate.allowedScopes;
+    if (!Array.isArray(allowedScopes) || allowedScopes.length === 0) {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, "child() must declare allowedScopes to enforce scope union.");
+    }
+    for (const scope of allowedScopes) {
+        if (!ALLOWED_SCOPES.includes(scope)) {
+            throw new NonComplianceError(API_SURFACE_VIOLATION, `child() scope not allowed: ${String(scope)}.`);
+        }
+    }
+}
+export function assertApiSurface(surface) {
+    if (!surface || typeof surface !== "object") {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, "API surface must be an object.");
+    }
+    const api = surface;
+    const keys = Object.keys(api);
+    for (const key of keys) {
+        if (FORBIDDEN_NAMES.has(key)) {
+            throw new NonComplianceError(API_SURFACE_VIOLATION, `Forbidden API method detected: ${key}.`);
+        }
+    }
+    if (!("step" in api)) {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, "API surface must expose step(message).");
+    }
+    assertFunction(api.step, "step", 1);
+    if ("flush" in api) {
+        assertFunction(api.flush, "flush", 0);
+    }
+    if ("child" in api) {
+        assertFunction(api.child, "child", 1);
+        assertChildScopePolicy(api.child);
+    }
+    for (const key of keys) {
+        if (key !== "step" && key !== "child" && key !== "flush") {
+            throw new NonComplianceError(API_SURFACE_VIOLATION, `Unexpected API export: ${key}.`);
+        }
+    }
+}
+//# sourceMappingURL=api_surface_guard.js.map

package/dist/validate/api_surface_guard.js.map

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

package/dist/validate/noncompliance.d.ts

@@ -0,0 +1,15 @@
+export declare const API_SURFACE_VIOLATION: "API_SURFACE_VIOLATION";
+export declare const CONTEXT_INJECTION_VIOLATION: "CONTEXT_INJECTION_VIOLATION";
+export declare const PAYLOAD_EMBEDDING_VIOLATION: "PAYLOAD_EMBEDDING_VIOLATION";
+export declare const CANONICAL_SCHEMA_VIOLATION: "CANONICAL_SCHEMA_VIOLATION";
+export declare const SINK_MUTATION_VIOLATION: "SINK_MUTATION_VIOLATION";
+export declare const NO_AUTHORITATIVE_SINK: "NO_AUTHORITATIVE_SINK";
+export declare const FANOUT_NONDETERMINISM: "FANOUT_NONDETERMINISM";
+export declare const AUTHORITATIVE_FAILURE_SWALLOWED: "AUTHORITATIVE_FAILURE_SWALLOWED";
+export declare const UNBOUNDED_BUFFER_RISK: "UNBOUNDED_BUFFER_RISK";
+export type NonComplianceCode = typeof API_SURFACE_VIOLATION | typeof CONTEXT_INJECTION_VIOLATION | typeof PAYLOAD_EMBEDDING_VIOLATION | typeof CANONICAL_SCHEMA_VIOLATION | typeof SINK_MUTATION_VIOLATION | typeof NO_AUTHORITATIVE_SINK | typeof FANOUT_NONDETERMINISM | typeof AUTHORITATIVE_FAILURE_SWALLOWED | typeof UNBOUNDED_BUFFER_RISK;
+export declare class NonComplianceError extends Error {
+    readonly code: NonComplianceCode;
+    constructor(code: NonComplianceCode, message: string);
+}
+//# sourceMappingURL=noncompliance.d.ts.map

package/dist/validate/noncompliance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noncompliance.d.ts","sourceRoot":"","sources":["../../src/validate/noncompliance.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,2BAA2B,EACtC,6BAAsC,CAAC;AACzC,eAAO,MAAM,2BAA2B,EACtC,6BAAsC,CAAC;AACzC,eAAO,MAAM,0BAA0B,EACrC,4BAAqC,CAAC;AACxC,eAAO,MAAM,uBAAuB,EAAG,yBAAkC,CAAC;AAC1E,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,+BAA+B,EAC1C,iCAA0C,CAAC;AAC7C,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AAEtE,MAAM,MAAM,iBAAiB,GACzB,OAAO,qBAAqB,GAC5B,OAAO,2BAA2B,GAClC,OAAO,2BAA2B,GAClC,OAAO,0BAA0B,GACjC,OAAO,uBAAuB,GAC9B,OAAO,qBAAqB,GAC5B,OAAO,qBAAqB,GAC5B,OAAO,+BAA+B,GACtC,OAAO,qBAAqB,CAAC;AAEjC,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAIrD"}

package/dist/validate/noncompliance.js

@@ -0,0 +1,17 @@
+export const API_SURFACE_VIOLATION = "API_SURFACE_VIOLATION";
+export const CONTEXT_INJECTION_VIOLATION = "CONTEXT_INJECTION_VIOLATION";
+export const PAYLOAD_EMBEDDING_VIOLATION = "PAYLOAD_EMBEDDING_VIOLATION";
+export const CANONICAL_SCHEMA_VIOLATION = "CANONICAL_SCHEMA_VIOLATION";
+export const SINK_MUTATION_VIOLATION = "SINK_MUTATION_VIOLATION";
+export const NO_AUTHORITATIVE_SINK = "NO_AUTHORITATIVE_SINK";
+export const FANOUT_NONDETERMINISM = "FANOUT_NONDETERMINISM";
+export const AUTHORITATIVE_FAILURE_SWALLOWED = "AUTHORITATIVE_FAILURE_SWALLOWED";
+export const UNBOUNDED_BUFFER_RISK = "UNBOUNDED_BUFFER_RISK";
+export class NonComplianceError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=noncompliance.js.map

package/dist/validate/noncompliance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noncompliance.js","sourceRoot":"","sources":["../../src/validate/noncompliance.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AACtE,MAAM,CAAC,MAAM,2BAA2B,GACtC,6BAAsC,CAAC;AACzC,MAAM,CAAC,MAAM,2BAA2B,GACtC,6BAAsC,CAAC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GACrC,4BAAqC,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAkC,CAAC;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AACtE,MAAM,CAAC,MAAM,+BAA+B,GAC1C,iCAA0C,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AAatE,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAoB;IAEjC,YAAY,IAAuB,EAAE,OAAe;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/validate/schema_guard.d.ts

@@ -0,0 +1,5 @@
+import type { StepRecord } from "../core/types.js";
+import type { SinkEntry } from "../sinks/sink_types.js";
+export declare function assertStepRecord(record: unknown): asserts record is StepRecord;
+export declare function assertHasAuthoritativeSink(sinks: ReadonlyArray<SinkEntry>): void;
+//# sourceMappingURL=schema_guard.d.ts.map

package/dist/validate/schema_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema_guard.d.ts","sourceRoot":"","sources":["../../src/validate/schema_guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA0DxD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CA8G9E;AAID,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAC9B,IAAI,CAWN"}

package/dist/validate/schema_guard.js

@@ -0,0 +1,151 @@
+import { assertValidMessage } from "../core/message_constraints.js";
+import { CANONICAL_SCHEMA_VIOLATION, CONTEXT_INJECTION_VIOLATION, NO_AUTHORITATIVE_SINK, PAYLOAD_EMBEDDING_VIOLATION, NonComplianceError, } from "./noncompliance.js";
+const REQUIRED_FIELDS = [
+    "record_version",
+    "record_id",
+    "sequence",
+    "timestamp_utc",
+    "monotonic_time",
+    "institution",
+    "system_name",
+    "system_type",
+    "environment",
+    "system_version",
+    "message",
+    "context_hash",
+    "context_version",
+    "record_hash",
+    "hash_algorithm",
+];
+const OPTIONAL_FIELDS = [
+    "instance_id",
+    "trace_id",
+    "span_id",
+    "parent_step_id",
+    "surface_type",
+    "surface_name",
+    "surface_instance",
+    "source_file",
+    "source_module",
+    "source_function",
+    "source_line",
+    "message_code",
+    "evidence_refs",
+];
+const ALLOWED_FIELDS = new Set([...REQUIRED_FIELDS, ...OPTIONAL_FIELDS]);
+const CONTEXT_FIELDS = ["context", "context_blob", "context_data", "context_value"];
+// Explicit type assertion for string keys from Object.keys(schema.properties)
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "Step record must be a plain object.");
+    }
+    return value;
+}
+export function assertStepRecord(record) {
+    const candidate = asRecord(record);
+    if (!Object.isFrozen(candidate)) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "Step record must be immutable at emission time.");
+    }
+    for (const forbidden of CONTEXT_FIELDS) {
+        if (forbidden in candidate) {
+            throw new NonComplianceError(CONTEXT_INJECTION_VIOLATION, "Context must not be embedded in the step record.");
+        }
+    }
+    for (const key of Object.keys(candidate)) {
+        if (!ALLOWED_FIELDS.has(key)) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `Unexpected field in step record: ${key}.`);
+        }
+    }
+    for (const field of REQUIRED_FIELDS) {
+        if (!(field in candidate)) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `Missing required field: ${field}.`);
+        }
+    }
+    assertStringField(candidate, "record_version");
+    assertStringField(candidate, "record_id");
+    assertIntegerField(candidate, "sequence");
+    assertStringField(candidate, "timestamp_utc");
+    assertNumberField(candidate, "monotonic_time");
+    assertStringField(candidate, "institution");
+    assertStringField(candidate, "system_name");
+    assertStringField(candidate, "system_type");
+    assertStringField(candidate, "environment");
+    assertStringField(candidate, "system_version");
+    assertStringField(candidate, "context_hash");
+    assertStringField(candidate, "context_version");
+    assertStringField(candidate, "record_hash");
+    assertStringField(candidate, "hash_algorithm");
+    if (candidate.record_version !== "log.step.v1") {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "record_version must be log.step.v1.");
+    }
+    try {
+        assertValidMessage(candidate.message);
+    }
+    catch (error) {
+        throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, error instanceof Error ? error.message : "Invalid message content.");
+    }
+    if (typeof candidate.timestamp_utc === "string") {
+        const parsed = Date.parse(candidate.timestamp_utc);
+        if (Number.isNaN(parsed)) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "timestamp_utc must be a valid ISO-8601 string.");
+        }
+    }
+    assertOptionalStringField(candidate, "instance_id");
+    assertOptionalStringField(candidate, "trace_id");
+    assertOptionalStringField(candidate, "span_id");
+    assertOptionalStringField(candidate, "parent_step_id");
+    assertOptionalStringField(candidate, "surface_type");
+    assertOptionalStringField(candidate, "surface_name");
+    assertOptionalStringField(candidate, "surface_instance");
+    assertOptionalStringField(candidate, "source_file");
+    assertOptionalStringField(candidate, "source_module");
+    assertOptionalStringField(candidate, "source_function");
+    assertOptionalStringField(candidate, "message_code");
+    if ("source_line" in candidate && candidate.source_line !== undefined) {
+        assertNumberField(candidate, "source_line");
+    }
+    if ("evidence_refs" in candidate && candidate.evidence_refs !== undefined) {
+        if (!Array.isArray(candidate.evidence_refs)) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "evidence_refs must be an array of strings.");
+        }
+        for (const ref of candidate.evidence_refs) {
+            if (typeof ref !== "string" || ref.length === 0) {
+                throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "evidence_refs must contain non-empty strings.");
+            }
+        }
+    }
+}
+// Explicit type assertion for string keys from Object.keys(schema.properties)
+export function assertHasAuthoritativeSink(sinks) {
+    const hasAuthoritative = sinks.some((entry) => entry.sinkClass === "authoritative");
+    if (!hasAuthoritative) {
+        throw new NonComplianceError(NO_AUTHORITATIVE_SINK, "At least one authoritative sink is required.");
+    }
+}
+function assertStringField(record, field) {
+    const value = record[field];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `${field} must be a non-empty string.`);
+    }
+}
+function assertOptionalStringField(record, field) {
+    if (field in record && record[field] !== undefined) {
+        const value = record[field];
+        if (typeof value !== "string" || value.length === 0) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `${field} must be a non-empty string when provided.`);
+        }
+    }
+}
+function assertNumberField(record, field) {
+    const value = record[field];
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `${field} must be a finite number.`);
+    }
+}
+function assertIntegerField(record, field) {
+    const value = record[field];
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `${field} must be a non-negative integer.`);
+    }
+}
+//# sourceMappingURL=schema_guard.js.map

package/dist/validate/schema_guard.js.map

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

package/evidence/audit/llm/llm_audit_report_2026-01-25T15-11-32Z.json

@@ -0,0 +1,30 @@
+{
+  "repo": {
+    "path": "C:\\Ananda\\projects\\unifyplane\\LogSDK"
+  },
+  "audit_input_path": "C:\\Ananda\\projects\\unifyplane\\LogSDK",
+  "audit_root": "C:\\Ananda\\projects\\unifyplane\\LogSDK",
+  "generated_at_utc": "2026-01-25T15:11:32Z",
+  "overall_status": "BLOCKED",
+  "blocking_failure": {
+    "missing_surfaces": [
+      "plans"
+    ],
+    "reason": "Missing required repository surfaces"
+  },
+  "runtime_contract": {
+    "exists": true,
+    "path": "contracts/repo.runtime.json",
+    "valid": null,
+    "notes": "Not evaluated because audit was blocked on missing surfaces"
+  },
+  "derived_runtime_diagnostics": {
+    "signals": null,
+    "surfaces": null,
+    "notes": "Diagnostics not computed due to blocking failure"
+  },
+  "rule_findings": [],
+  "summary": {
+    "notes": "Audit blocked before runtime evaluation because required surfaces were missing (plans)."
+  }
+}

package/evidence/audit/llm/llm_audit_report_2026-01-25T15-53-20Z.json

@@ -0,0 +1,154 @@
+{
+  "repo": {
+    "path": "C:\\Ananda\\projects\\unifyplane\\LogSDK",
+    "name": "@unifyplane/logsdk",
+    "runtime_manifest": "contracts/repo.runtime.json"
+  },
+  "audit_input_path": "C:\\Ananda\\projects\\unifyplane\\LogSDK",
+  "audit_root": "C:\\Ananda\\projects\\unifyplane\\LogSDK",
+  "generated_at_utc": "2026-01-25T15:53:20Z",
+  "overall_status": "FAIL",
+  "blocking_failure": null,
+  "runtime_contract": {
+    "exists": true,
+    "path": "contracts/repo.runtime.json",
+    "schema_path": "contracts/schemas/repo/repo.runtime.v1.schema.json",
+    "valid": true,
+    "record_version": "repo.runtime.v1",
+    "authoritative_repo_role": "enterprise-substrate-logging",
+    "repo_role": "enterprise-substrate-logging",
+    "repo_id": "unifyplane-logsdk",
+    "module_system": "esm",
+    "node_target": "node22",
+    "tsconfig_path": "tsconfig.json",
+    "dist_entry": "dist/index.js",
+    "json_strategy": "esm-import"
+  },
+  "derived_runtime_diagnostics": {
+    "signals": {
+      "audit_root_resolution": "Starting at C:\\Ananda\\projects\\unifyplane\\LogSDK (package.json located here)",
+      "package_json_type": "module",
+      "tsconfig_module": "ES2022",
+      "tsconfig_moduleResolution": "Bundler",
+      "dist_require_matches": false,
+      "dist_import_matches": true,
+      "dist_export_matches": true,
+      "dist_has_contracts_dir": false,
+      "dist_has_schemas_dir": false
+    },
+    "surfaces": {
+      "agents_md": true,
+      "package_json": true,
+      "tsconfig_json": true,
+      "src_dir": true,
+      "app_dir": false,
+      "plans_dir": false,
+      "tools_dir": true,
+      "tests_dir": true,
+      "contracts_dir": true,
+      "evidence_dir": true,
+      "dist_dir": true
+    }
+  },
+  "rule_findings": [
+    {
+      "rule_id": "BUILD-DIST-001",
+      "status": "PASS",
+      "scope": "REPO_STATIC",
+      "evidence": "dist/ directory exists with compiled artifacts such as dist/index.js"
+    },
+    {
+      "rule_id": "DEP-SDK-001",
+      "status": "PASS",
+      "scope": "REPO_STATIC",
+      "evidence": "package.json declares no dependencies and dependency_policy.mode=workspace-allowed"
+    },
+    {
+      "rule_id": "DIST-ENTRY-001",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "runtime manifest dist_entry=dist/index.js and the file exists"
+    },
+    {
+      "rule_id": "LOG-FORB-001",
+      "status": "PASS",
+      "scope": "REPO_STATIC",
+      "evidence": "No console.log occurrences exist within src/ or dist/ (rg search returned nothing)"
+    },
+    {
+      "rule_id": "META-RUNTIME-001",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "contracts/repo.runtime.json is present"
+    },
+    {
+      "rule_id": "META-RUNTIME-002",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Derived schema contracts/schemas/repo/repo.runtime.v1.schema.json exists"
+    },
+    {
+      "rule_id": "META-RUNTIME-003",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Runtime contract satisfies the schema (required keys, enums, ajv structure, etc.)"
+    },
+    {
+      "rule_id": "META-RUNTIME-004",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "record_version equals repo.runtime.v1"
+    },
+    {
+      "rule_id": "MOD-CJS-001",
+      "status": "NOT_APPLICABLE",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Module system is declared as esm so CJS-specific requirement is not evaluated"
+    },
+    {
+      "rule_id": "MOD-CJS-002",
+      "status": "NOT_APPLICABLE",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Module system is declared as esm so CJS-specific requirement is not evaluated"
+    },
+    {
+      "rule_id": "MOD-CJS-003",
+      "status": "NOT_APPLICABLE",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Module system is declared as esm so CJS-specific requirement is not evaluated"
+    },
+    {
+      "rule_id": "MOD-ESM-001",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "dist/index.js uses static ESM import/export statements with .js extensions"
+    },
+    {
+      "rule_id": "MOD-ESM-002",
+      "status": "VIOLATION",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "tsconfig.json lines 4-5 (module=ES2022, moduleResolution=Bundler) are not NodeNext/NodeNext as required"
+    },
+    {
+      "rule_id": "TEST-SEM-001",
+      "status": "GAP",
+      "scope": "REPO_STATIC",
+      "evidence": "Cannot confirm dist-aligned tests because npm/node commands are disallowed by instructions"
+    },
+    {
+      "rule_id": "TOOL-PURITY-001",
+      "status": "PASS",
+      "scope": "REPO_STATIC",
+      "evidence": "tools/ contains only test-result helpers under tools/test_results, so tooling does not pollute runtime dist artifacts"
+    }
+  ],
+  "summary": {
+    "blocking_failure": null,
+    "violation_count": 1,
+    "gap_count": 1,
+    "overall_status": "FAIL",
+    "explicit_violations": [
+      "MOD-ESM-002"
+    ]
+  }
+}

package/evidence/audit/llm/llm_audit_report_2026-01-25T16-14-52Z.json

@@ -0,0 +1,130 @@
+{
+  "repo": {
+    "path": "C:\\Ananda\\projects\\unifyplane\\LogSDK",
+    "name": "@unifyplane/logsdk",
+    "runtime_manifest": "contracts/repo.runtime.json"
+  },
+  "audit_input_path": "C:\\Ananda\\projects\\unifyplane\\LogSDK",
+  "audit_root": "C:\\Ananda\\projects\\unifyplane\\LogSDK",
+  "generated_at_utc": "2026-01-25T16:14:52Z",
+  "overall_status": "FAIL",
+  "blocking_failure": null,
+  "runtime_contract": {
+    "exists": true,
+    "path": "contracts/repo.runtime.json",
+    "schema_path": "contracts\\schemas\\repo\\repo.runtime.v1.schema.json",
+    "valid": true,
+    "record_version": "repo.runtime.v1",
+    "authoritative_repo_role": "enterprise-substrate-logging",
+    "repo_role": "enterprise-substrate-logging",
+    "repo_id": "unifyplane-logsdk",
+    "module_system": "esm",
+    "node_target": "node22",
+    "tsconfig_path": "tsconfig.json",
+    "dist_entry": "dist/index.js",
+    "json_strategy": "esm-import"
+  },
+  "derived_runtime_diagnostics": {
+    "signals": null,
+    "surfaces": null
+  },
+  "rule_findings": [
+    {
+      "rule_id": "BUILD-DIST-001",
+      "status": "VIOLATION",
+      "scope": "REPO_STATIC",
+      "evidence": "dist/ directory exists with compiled artifacts such as dist/index.js"
+    },
+    {
+      "rule_id": "DEP-SDK-001",
+      "status": "PASS",
+      "scope": "REPO_STATIC",
+      "evidence": "package.json declares no dependencies and dependency_policy.mode=workspace-allowed"
+    },
+    {
+      "rule_id": "DIST-ENTRY-001",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "runtime manifest dist_entry=dist/index.js and the file exists"
+    },
+    {
+      "rule_id": "LOG-FORB-001",
+      "status": "PASS",
+      "scope": "REPO_STATIC",
+      "evidence": "rg -n console\\\\.log src dist produced no matches, so no adhoc console logging"
+    },
+    {
+      "rule_id": "META-RUNTIME-001",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "contracts/repo.runtime.json is present"
+    },
+    {
+      "rule_id": "META-RUNTIME-002",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Derived schema contracts\\schemas\\repo\\repo.runtime.v1.schema.json exists"
+    },
+    {
+      "rule_id": "META-RUNTIME-003",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Runtime contract satisfies the schema constraints (required keys, enums, ajv structure, etc.)"
+    },
+    {
+      "rule_id": "META-RUNTIME-004",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "record_version equals repo.runtime.v1"
+    },
+    {
+      "rule_id": "MOD-CJS-001",
+      "status": "NOT_APPLICABLE",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Module system is declared as esm so CJS-specific requirement is not evaluated"
+    },
+    {
+      "rule_id": "MOD-CJS-002",
+      "status": "NOT_APPLICABLE",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Module system is declared as esm so CJS-specific requirement is not evaluated"
+    },
+    {
+      "rule_id": "MOD-CJS-003",
+      "status": "NOT_APPLICABLE",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "Module system is declared as esm so CJS-specific requirement is not evaluated"
+    },
+    {
+      "rule_id": "MOD-ESM-001",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "dist/index.js uses static ESM imports/exports with .js extensions"
+    },
+    {
+      "rule_id": "MOD-ESM-002",
+      "status": "PASS",
+      "scope": "RUNTIME_CONTRACT",
+      "evidence": "tsconfig.json module and moduleResolution are both NodeNext"
+    },
+    {
+      "rule_id": "TEST-SEM-001",
+      "status": "GAP",
+      "scope": "REPO_STATIC",
+      "evidence": "Cannot confirm dist-aligned tests because npm/node commands are disallowed by instructions"
+    },
+    {
+      "rule_id": "TOOL-PURITY-001",
+      "status": "PASS",
+      "scope": "REPO_STATIC",
+      "evidence": "tools/ contains only the t helper folder, so tooling does not pollute runtime dist artifacts"
+    }
+  ],
+  "summary": {
+    "blocking_failure": null,
+    "violation_count": 1,
+    "gap_count": 4,
+    "overall_status": "FAIL",
+    "explicit_violations": "BUILD-DIST-001"
+  }
+}