Files
maka/scripts/check-astryx-surface-inventory.mjs
T
agent-radar 7be535059e
Dependency audit / audit (push) Canceled after 0s
CI / plan (push) Canceled after 0s
Gitoxide helper admission / macos-latest (push) Canceled after 0s
Gitoxide helper admission / ubuntu-latest (push) Canceled after 0s
Gitoxide helper admission / windows-latest (push) Canceled after 0s
Runtime Host peer admission / quality (push) Canceled after 0s
Windows recovery / windows_recovery (push) Canceled after 0s
CI / heavy (push) Canceled after 0s
CI / test (push) Canceled after 0s
源码快照 @ 2026-09-01 (source-only, 剔除非源码素材)
2026-09-01 19:05:14 +08:00

99 lines
3.4 KiB
JavaScript

#!/usr/bin/env node
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
/**
* Coverage gate: committed inventory artifacts match a fresh generator run.
*
* These files are generated. Hand-editing one half (or leaving a deleted
* path in the Markdown table) is the failure mode. Regenerating and
* comparing bytes is the invariant — not a second, hand-written file list.
*
* Run: npm run astryx:surface-inventory
* Fix: npm run astryx:surface-inventory:write
*/
import { readFileSync, existsSync } from 'node:fs';
import { join } from 'node:path';
import { fileURLToPath } from 'node:url';
import { renderAstryxSurfaceInventory } from './generate-astryx-surface-inventory.mjs';
const root = join(fileURLToPath(new URL('..', import.meta.url)));
const pathsFile = join(root, 'docs/astryx-surface-file-inventory.paths');
const mdFile = join(root, 'docs/astryx-surface-file-inventory.md');
function main() {
if (!existsSync(pathsFile) || !existsSync(mdFile)) {
console.error('missing inventory artifacts — run: npm run astryx:surface-inventory:write');
process.exit(1);
}
const rendered = renderAstryxSurfaceInventory(root);
const committedMd = readFileSync(mdFile, 'utf8');
const committedPaths = readFileSync(pathsFile, 'utf8');
const mdDrift = committedMd !== rendered.markdown;
const pathsDrift = committedPaths !== rendered.paths;
if (!mdDrift && !pathsDrift) {
console.log(
`astryx surface inventory coverage: ok (${rendered.files.length} files, ${rendered.excluded.length} exclusions)`,
);
return;
}
const committedPathSet = new Set(
committedPaths
.split('\n')
.map((line) => line.trim())
.filter(Boolean),
);
const generatedPathSet = new Set(rendered.files);
const missing = rendered.files.filter((file) => !committedPathSet.has(file));
const extra = [...committedPathSet].filter((file) => !generatedPathSet.has(file));
const details = [];
if (pathsDrift) {
details.push('.paths does not match generator output');
if (missing.length) {
details.push(
`on disk but not in .paths (${missing.length}):\n ${missing.slice(0, 20).join('\n ')}`,
);
}
if (extra.length) {
details.push(
`in .paths but not on disk (${extra.length}):\n ${extra.slice(0, 20).join('\n ')}`,
);
}
}
if (mdDrift) {
details.push('docs/astryx-surface-file-inventory.md does not match generator output');
}
console.error(
`astryx surface inventory is stale; run: npm run astryx:surface-inventory:write\n${details.map((line) => `- ${line}`).join('\n')}`,
);
process.exit(1);
}
try {
main();
} catch (error) {
console.error(error);
process.exit(1);
}