feat: compile revisions from area config snapshots

test/road-revisions.js

@@ -6,6 +6,7 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { nativeRoadEdits, roadRevisions } = require('../src');
+const { compileInput } = require('../src/compile/compiler');
 
 const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'road-revisions-'));
 const source = '<osm version="0.6"><node id="1" lon="114.1" lat="22.5"/></osm>\n';
@@ -15,6 +16,7 @@ const signals = {
   provenance: 'empty',
   assemblies: { type: 'FeatureCollection', features: [] },
 };
+const options = { edgeLines: false, junctionTemplates: { enabled: false, references: [] } };
 
 fs.writeFileSync(path.join(directory, 'source.osm'), source);
 fs.writeFileSync(path.join(directory, 'native-road-overrides.json'), `${JSON.stringify(overrides, null, 2)}\n`);
@@ -26,19 +28,21 @@ const legacyBytes = new Map(
   ]),
 );
 
-const first = roadRevisions.ensureRevisionStore(directory);
+const first = roadRevisions.ensureRevisionStore(directory, options);
 assert.equal(first.baseline.manifest.id, 'rev-0001');
 assert.equal(first.baseline.manifest.schema, roadRevisions.REVISION_SCHEMA);
 assert.equal(first.active.activeRevisionId, 'rev-0001');
 assert.equal(first.baseline.directEdits.schema, nativeRoadEdits.EDITS_SCHEMA);
 assert.equal(first.baseline.directEdits.documentVersion, 0);
+assert.equal(first.baseline.directEdits.base.areaConfigSha256, first.baseline.manifest.source.areaConfigSha256);
+assert.deepEqual(first.baseline.areaConfig, options);
 for (const [file, bytes] of legacyBytes)
   assert.deepEqual(fs.readFileSync(path.join(directory, file)), bytes, `${file} remains byte-for-byte unchanged`);
 
 const digest = crypto.createHash('sha256').update(source).digest('hex');
 assert.equal(first.baseline.manifest.source.osmSha256, digest);
 assert.equal(fs.readdirSync(path.join(directory, 'osm')).filter((file) => file.endsWith('.osm')).length, 1);
-roadRevisions.ensureRevisionStore(directory);
+roadRevisions.ensureRevisionStore(directory, options);
 assert.equal(
   fs.readdirSync(path.join(directory, 'osm')).filter((file) => file.endsWith('.osm')).length,
   1,
@@ -47,6 +51,7 @@ assert.equal(
 
 const activeEdits = nativeRoadEdits.emptyEditDocument({
   osmSha256: digest,
+  areaConfigSha256: first.baseline.manifest.source.areaConfigSha256,
   compilerGeometryVersion: 'native-road-package/v1.1',
 });
 activeEdits.operations = [{ id: 'op-1', createdAt: '2026-08-26T12:00:00.000Z', constraintIds: [] }];
@@ -58,6 +63,7 @@ assert.equal(checkpoint.manifest.parentRevisionId, 'rev-0001');
 assert.deepEqual(checkpoint.nativeRoadOverrides, overrides);
 assert.deepEqual(checkpoint.trafficSignals, signals);
 assert.deepEqual(checkpoint.directEdits, activeEdits);
+assert.deepEqual(checkpoint.areaConfig, options);
 assert.equal(
   checkpoint.manifest.digests.nativeRoadOverrides,
   crypto
@@ -72,6 +78,54 @@ assert.deepEqual(
 );
 assert.throws(() => roadRevisions.createCheckpoint(directory, ''), /label must be a non-empty string/);
 assert.throws(() => roadRevisions.readRevision(directory, '../rev-0002'), /Invalid revision id/);
+const changedOptions = { edgeLines: true, junctionTemplates: { enabled: false, references: [] } };
+const changedSnapshot = roadRevisions.setActiveAreaConfig(directory, changedOptions);
+assert.equal(
+  nativeRoadEdits.loadEditDocument(path.join(directory, 'active', 'native-road-edits.json')).base.areaConfigSha256,
+  changedSnapshot.areaConfig.digest,
+  'the active document points to the current snapshot',
+);
+assert.equal(
+  nativeRoadEdits.loadEditDocument(path.join(directory, 'active', 'native-road-edits.json')).documentVersion,
+  1,
+  'updating the active snapshot is a versioned document write',
+);
+assert.deepEqual(
+  roadRevisions.readRevision(directory, 'rev-0002').areaConfig,
+  options,
+  'old revisions retain their snapshot',
+);
+roadRevisions.setActiveAreaConfig(directory, options);
+
+const fixture = path.join(__dirname, 'fixtures', 'fengshu-er-road.osm');
+fs.copyFileSync(fixture, path.join(directory, 'source.osm'));
+const frozen = roadRevisions.createCheckpoint(directory, 'Fixture baseline');
+const snapshot = path.join(directory, 'active', 'area-config.snapshot.json');
+const compileBase = {
+  areaId: 'snapshot-test',
+  osmFile: path.join(directory, 'source.osm'),
+  outDir: path.join(directory, 'snapshot-output'),
+  stagingDir: path.join(directory, 'snapshot-pipeline'),
+  overridesFile: path.join(directory, 'native-road-overrides.json'),
+  trafficSignalsFile: path.join(directory, 'native-traffic-signals.json'),
+  options: { edgeLines: true, junctionTemplates: { enabled: false, references: [] } },
+  areaConfigSnapshotFile: snapshot,
+};
+const fromSnapshot = compileInput(compileBase);
+assert.equal(fromSnapshot.area.nativeRoad.edgeLines, false, 'the snapshot wins over changed external options');
+const fromRevision = compileInput({
+  ...compileBase,
+  areaId: 'frozen-revision-test',
+  outDir: path.join(directory, 'revision-output'),
+  stagingDir: path.join(directory, 'revision-pipeline'),
+  osmFile: path.join(directory, frozen.manifest.source.osmFile),
+  areaConfigSnapshotFile: path.join(directory, 'revisions', frozen.manifest.id, 'area-config.snapshot.json'),
+});
+assert.equal(fromRevision.area.nativeRoad.edgeLines, false, 'a frozen revision ignores later external config changes');
+assert.throws(
+  () => compileInput({ ...compileBase, areaConfigSnapshotFile: path.join(directory, 'missing.snapshot.json') }),
+  /Area config snapshot is missing/,
+);
 
 fs.rmSync(directory, { recursive: true, force: true });
 console.log('road revision storage tests passed');