mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-18 23:03:06 +08:00
Add preview pack smoke gate
This commit is contained in:
Affaan Mustafa
@@ -469,6 +469,7 @@ function buildRequirements(rootDir, platformReport) {
|
||||
const publicationReadiness = readText(rootDir, 'docs/releases/2.0.0-rc.1/publication-readiness.md');
|
||||
const namingMatrix = readText(rootDir, 'docs/releases/2.0.0-rc.1/naming-and-publication-matrix.md');
|
||||
const previewManifest = readText(rootDir, 'docs/releases/2.0.0-rc.1/preview-pack-manifest.md');
|
||||
const previewPackSmoke = readText(rootDir, 'scripts/preview-pack-smoke.js');
|
||||
const progressSync = readText(rootDir, 'docs/architecture/progress-sync-contract.md');
|
||||
const observabilityReadiness = readText(rootDir, 'docs/architecture/observability-readiness.md');
|
||||
const stalePrSalvage = readText(rootDir, 'docs/stale-pr-salvage-ledger.md');
|
||||
@@ -478,6 +479,22 @@ function buildRequirements(rootDir, platformReport) {
|
||||
const packageJson = readPackage(rootDir);
|
||||
const scripts = packageJson.scripts || {};
|
||||
const legacyContext = { stalePrSalvage, legacyInventory, roadmap };
|
||||
const previewPackManifestReady = includesAll(previewManifest, [
|
||||
'publication-readiness.md',
|
||||
'release-notes.md',
|
||||
'quickstart.md'
|
||||
]);
|
||||
const previewPackSmokeReady = scripts['preview-pack:smoke'] === 'node scripts/preview-pack-smoke.js'
|
||||
&& fileExists(rootDir, 'scripts/preview-pack-smoke.js')
|
||||
&& includesAll(previewManifest, ['scripts/preview-pack-smoke.js', 'npm run preview-pack:smoke'])
|
||||
&& includesAll(previewPackSmoke, [
|
||||
'ecc.preview-pack-smoke.v1',
|
||||
'preview-pack-artifacts-present',
|
||||
'hermes-boundary-sanitized',
|
||||
'publication-blockers-preserved'
|
||||
]);
|
||||
const hermesArtifactsReady = fileExists(rootDir, 'docs/HERMES-SETUP.md')
|
||||
&& fileExists(rootDir, 'skills/hermes-imports/SKILL.md');
|
||||
|
||||
const githubLive = !platformReport.github.skipped && platformReport.github.totals.errors === 0;
|
||||
const queuesCurrent = githubLive
|
||||
@@ -535,23 +552,29 @@ function buildRequirements(rootDir, platformReport) {
|
||||
'ecc-preview-pack',
|
||||
'ECC 2.0 preview pack ready',
|
||||
'docs/releases/2.0.0-rc.1/preview-pack-manifest.md',
|
||||
includesAll(previewManifest, ['publication-readiness.md', 'release-notes.md', 'quickstart.md']) ? 'in_progress' : 'not_complete',
|
||||
includesAll(previewManifest, ['publication-readiness.md', 'release-notes.md', 'quickstart.md'])
|
||||
previewPackManifestReady && previewPackSmokeReady ? 'current' : previewPackManifestReady ? 'in_progress' : 'not_complete',
|
||||
previewPackManifestReady && previewPackSmokeReady
|
||||
? 'preview pack manifest and deterministic smoke gate are in-tree'
|
||||
: previewPackManifestReady
|
||||
? 'preview pack manifest is in-tree'
|
||||
: 'preview pack manifest is incomplete',
|
||||
'final clean-checkout release approval and publish evidence still pending'
|
||||
previewPackManifestReady && previewPackSmokeReady
|
||||
? 'repeat clean-checkout preview-pack smoke before publication'
|
||||
: 'final clean-checkout release approval and publish evidence still pending'
|
||||
),
|
||||
buildRequirement(
|
||||
'hermes-specialized-skills',
|
||||
'Include Hermes specialized skills safely',
|
||||
'docs/HERMES-SETUP.md and skills/hermes-imports/SKILL.md',
|
||||
fileExists(rootDir, 'docs/HERMES-SETUP.md') && fileExists(rootDir, 'skills/hermes-imports/SKILL.md')
|
||||
? 'in_progress'
|
||||
: 'not_complete',
|
||||
fileExists(rootDir, 'docs/HERMES-SETUP.md') && fileExists(rootDir, 'skills/hermes-imports/SKILL.md')
|
||||
hermesArtifactsReady && previewPackSmokeReady ? 'current' : hermesArtifactsReady ? 'in_progress' : 'not_complete',
|
||||
hermesArtifactsReady && previewPackSmokeReady
|
||||
? 'Hermes setup/import artifacts are covered by preview-pack smoke'
|
||||
: hermesArtifactsReady
|
||||
? 'Hermes setup and import skill are present'
|
||||
: 'Hermes setup/import artifacts missing',
|
||||
'final preview-pack smoke and release review pending'
|
||||
hermesArtifactsReady && previewPackSmokeReady
|
||||
? 'repeat preview-pack smoke before release review'
|
||||
: 'final preview-pack smoke and release review pending'
|
||||
),
|
||||
buildRequirement(
|
||||
'naming-and-plugin-publication',
|
||||
|
||||
353
scripts/preview-pack-smoke.js
Normal file
353
scripts/preview-pack-smoke.js
Normal file
@@ -0,0 +1,353 @@
|
||||
#!/usr/bin/env node
|
||||
'use strict';
|
||||
|
||||
const crypto = require('crypto');
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
const RELEASE = '2.0.0-rc.1';
|
||||
const RELEASE_DIR = `docs/releases/${RELEASE}`;
|
||||
const SCHEMA_VERSION = 'ecc.preview-pack-smoke.v1';
|
||||
|
||||
const REQUIRED_ARTIFACTS = [
|
||||
'README.md',
|
||||
'docs/HERMES-SETUP.md',
|
||||
'skills/hermes-imports/SKILL.md',
|
||||
'docs/architecture/cross-harness.md',
|
||||
'docs/architecture/harness-adapter-compliance.md',
|
||||
'docs/architecture/observability-readiness.md',
|
||||
'docs/architecture/progress-sync-contract.md',
|
||||
'scripts/preview-pack-smoke.js',
|
||||
`${RELEASE_DIR}/release-notes.md`,
|
||||
`${RELEASE_DIR}/quickstart.md`,
|
||||
`${RELEASE_DIR}/launch-checklist.md`,
|
||||
`${RELEASE_DIR}/publication-readiness.md`,
|
||||
`${RELEASE_DIR}/publication-evidence-2026-05-15.md`,
|
||||
`${RELEASE_DIR}/publication-evidence-2026-05-16.md`,
|
||||
`${RELEASE_DIR}/publication-evidence-2026-05-17.md`,
|
||||
`${RELEASE_DIR}/operator-readiness-dashboard-2026-05-17.md`,
|
||||
`${RELEASE_DIR}/naming-and-publication-matrix.md`,
|
||||
`${RELEASE_DIR}/x-thread.md`,
|
||||
`${RELEASE_DIR}/linkedin-post.md`,
|
||||
`${RELEASE_DIR}/article-outline.md`,
|
||||
`${RELEASE_DIR}/telegram-handoff.md`,
|
||||
`${RELEASE_DIR}/demo-prompts.md`,
|
||||
];
|
||||
|
||||
const REQUIRED_VERIFICATION_COMMANDS = [
|
||||
'git status --short --branch',
|
||||
'node scripts/platform-audit.js --format json --allow-untracked docs/drafts/',
|
||||
'npm run preview-pack:smoke',
|
||||
'npm run harness:adapters -- --check',
|
||||
'npm run harness:audit -- --format json',
|
||||
'npm run observability:ready',
|
||||
'npm run security:ioc-scan',
|
||||
'npm audit --audit-level=moderate',
|
||||
'npm audit signatures',
|
||||
'node tests/docs/ecc2-release-surface.test.js',
|
||||
'node tests/run-all.js',
|
||||
'cd ecc2 && cargo test',
|
||||
];
|
||||
|
||||
const REQUIRED_PUBLICATION_BLOCKERS = [
|
||||
'GitHub prerelease `v2.0.0-rc.1`',
|
||||
'npm `ecc-universal@2.0.0-rc.1`',
|
||||
'Claude plugin tag',
|
||||
'Codex repo-marketplace distribution evidence',
|
||||
'ECC Tools billing/product readiness',
|
||||
];
|
||||
|
||||
const HERMES_BOUNDARY_MARKERS = [
|
||||
'Public Release Candidate Scope',
|
||||
'ECC v2.0.0-rc.1 documents the Hermes surface',
|
||||
'Sanitization Checklist',
|
||||
'Do not ship raw workspace exports',
|
||||
'Output Contract',
|
||||
];
|
||||
|
||||
function usage() {
|
||||
console.log([
|
||||
'Usage: node scripts/preview-pack-smoke.js [--format <text|json>] [--root <dir>]',
|
||||
'',
|
||||
'Deterministic smoke gate for the ECC 2.0 rc.1 preview pack.',
|
||||
'',
|
||||
'Options:',
|
||||
' --format <text|json> Output format (default: text)',
|
||||
' --root <dir> Repository root to inspect (default: cwd)',
|
||||
' --help, -h Show this help',
|
||||
].join('\n'));
|
||||
}
|
||||
|
||||
function readArgValue(args, index, flagName) {
|
||||
const value = args[index + 1];
|
||||
if (!value || value.startsWith('--')) {
|
||||
throw new Error(`${flagName} requires a value`);
|
||||
}
|
||||
return value;
|
||||
}
|
||||
|
||||
function parseArgs(argv) {
|
||||
const args = argv.slice(2);
|
||||
const parsed = {
|
||||
format: 'text',
|
||||
help: false,
|
||||
root: path.resolve(process.cwd()),
|
||||
};
|
||||
|
||||
for (let index = 0; index < args.length; index += 1) {
|
||||
const arg = args[index];
|
||||
|
||||
if (arg === '--help' || arg === '-h') {
|
||||
parsed.help = true;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (arg === '--format') {
|
||||
parsed.format = readArgValue(args, index, arg).toLowerCase();
|
||||
index += 1;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (arg.startsWith('--format=')) {
|
||||
parsed.format = arg.slice('--format='.length).toLowerCase();
|
||||
continue;
|
||||
}
|
||||
|
||||
if (arg === '--root') {
|
||||
parsed.root = path.resolve(readArgValue(args, index, arg));
|
||||
index += 1;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (arg.startsWith('--root=')) {
|
||||
parsed.root = path.resolve(arg.slice('--root='.length));
|
||||
continue;
|
||||
}
|
||||
|
||||
throw new Error(`Unknown argument: ${arg}`);
|
||||
}
|
||||
|
||||
if (!['text', 'json'].includes(parsed.format)) {
|
||||
throw new Error(`Invalid format: ${parsed.format}. Use text or json.`);
|
||||
}
|
||||
|
||||
return parsed;
|
||||
}
|
||||
|
||||
function readText(rootDir, relativePath) {
|
||||
try {
|
||||
return fs.readFileSync(path.join(rootDir, relativePath), 'utf8');
|
||||
} catch (_error) {
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
function fileExists(rootDir, relativePath) {
|
||||
return fs.existsSync(path.join(rootDir, relativePath));
|
||||
}
|
||||
|
||||
function safeParseJson(text) {
|
||||
if (!text.trim()) {
|
||||
return null;
|
||||
}
|
||||
|
||||
try {
|
||||
return JSON.parse(text);
|
||||
} catch (_error) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
function includesAll(text, needles) {
|
||||
return needles.every(needle => text.includes(needle));
|
||||
}
|
||||
|
||||
function lineNumberForIndex(text, index) {
|
||||
return text.slice(0, index).split('\n').length;
|
||||
}
|
||||
|
||||
function findForbiddenContent(rootDir, relativePaths) {
|
||||
const offenders = [];
|
||||
const privatePathPattern = /\/Users\/(?!\.\.\.)[A-Za-z0-9._-]+|\/home\/(?!user|runner)[A-Za-z0-9._-]+/g;
|
||||
|
||||
for (const relativePath of relativePaths) {
|
||||
const text = readText(rootDir, relativePath);
|
||||
if (!text) {
|
||||
continue;
|
||||
}
|
||||
|
||||
for (const match of text.matchAll(privatePathPattern)) {
|
||||
offenders.push({
|
||||
path: relativePath,
|
||||
line: lineNumberForIndex(text, match.index),
|
||||
marker: match[0],
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
return offenders;
|
||||
}
|
||||
|
||||
function makeCheck(id, status, evidence, fix) {
|
||||
return {
|
||||
id,
|
||||
status,
|
||||
evidence,
|
||||
fix: status === 'pass' ? '' : fix,
|
||||
};
|
||||
}
|
||||
|
||||
function buildReport(options = {}) {
|
||||
const rootDir = path.resolve(options.root || process.cwd());
|
||||
const packageJson = safeParseJson(readText(rootDir, 'package.json')) || {};
|
||||
const packageScripts = packageJson.scripts || {};
|
||||
const packageFiles = Array.isArray(packageJson.files) ? packageJson.files : [];
|
||||
const manifestPath = `${RELEASE_DIR}/preview-pack-manifest.md`;
|
||||
const manifest = readText(rootDir, manifestPath);
|
||||
const hermesSetup = readText(rootDir, 'docs/HERMES-SETUP.md');
|
||||
const hermesSkill = readText(rootDir, 'skills/hermes-imports/SKILL.md');
|
||||
|
||||
const missingArtifacts = REQUIRED_ARTIFACTS.filter(relativePath => !fileExists(rootDir, relativePath));
|
||||
const unlistedArtifacts = REQUIRED_ARTIFACTS.filter(relativePath => !manifest.includes(`\`${relativePath}\``));
|
||||
const missingCommands = REQUIRED_VERIFICATION_COMMANDS.filter(command => !manifest.includes(command));
|
||||
const missingBlockers = REQUIRED_PUBLICATION_BLOCKERS.filter(blocker => !manifest.includes(blocker));
|
||||
const missingHermesMarkers = HERMES_BOUNDARY_MARKERS.filter(marker => !`${hermesSetup}\n${hermesSkill}`.includes(marker));
|
||||
const forbiddenContent = findForbiddenContent(rootDir, [
|
||||
...REQUIRED_ARTIFACTS,
|
||||
manifestPath,
|
||||
'docs/business/social-launch-copy.md',
|
||||
]);
|
||||
|
||||
const checks = [
|
||||
makeCheck(
|
||||
'preview-pack-script-registered',
|
||||
packageScripts['preview-pack:smoke'] === 'node scripts/preview-pack-smoke.js'
|
||||
&& packageFiles.includes('scripts/preview-pack-smoke.js')
|
||||
&& fileExists(rootDir, 'scripts/preview-pack-smoke.js')
|
||||
? 'pass'
|
||||
: 'fail',
|
||||
'package script and npm package file entry for preview-pack smoke gate',
|
||||
'Add preview-pack:smoke to package scripts and include scripts/preview-pack-smoke.js in package files.'
|
||||
),
|
||||
makeCheck(
|
||||
'preview-pack-artifacts-present',
|
||||
missingArtifacts.length === 0 && unlistedArtifacts.length === 0 ? 'pass' : 'fail',
|
||||
missingArtifacts.length === 0 && unlistedArtifacts.length === 0
|
||||
? `${REQUIRED_ARTIFACTS.length} required artifacts exist and are listed in the manifest`
|
||||
: `missing artifacts: ${missingArtifacts.join(', ') || 'none'}; unlisted artifacts: ${unlistedArtifacts.join(', ') || 'none'}`,
|
||||
'Restore missing preview-pack artifacts and list every required artifact in preview-pack-manifest.md.'
|
||||
),
|
||||
makeCheck(
|
||||
'final-verification-commands-listed',
|
||||
missingCommands.length === 0 ? 'pass' : 'fail',
|
||||
missingCommands.length === 0
|
||||
? `${REQUIRED_VERIFICATION_COMMANDS.length} final verification commands are listed`
|
||||
: `missing commands: ${missingCommands.join('; ')}`,
|
||||
'Add the missing final verification commands to preview-pack-manifest.md.'
|
||||
),
|
||||
makeCheck(
|
||||
'hermes-boundary-sanitized',
|
||||
missingHermesMarkers.length === 0 && forbiddenContent.length === 0 ? 'pass' : 'fail',
|
||||
missingHermesMarkers.length === 0 && forbiddenContent.length === 0
|
||||
? 'Hermes setup and import skill preserve the public sanitization boundary'
|
||||
: `missing markers: ${missingHermesMarkers.join(', ') || 'none'}; forbidden content: ${forbiddenContent.map(item => `${item.path}:${item.line}`).join(', ') || 'none'}`,
|
||||
'Restore Hermes sanitization language and remove private local paths from preview-pack docs.'
|
||||
),
|
||||
makeCheck(
|
||||
'publication-blockers-preserved',
|
||||
missingBlockers.length === 0
|
||||
&& /approval-gated release, package, plugin, and\s+announcement steps/.test(manifest)
|
||||
? 'pass'
|
||||
: 'fail',
|
||||
missingBlockers.length === 0
|
||||
? 'publication remains explicitly approval-gated'
|
||||
: `missing blockers: ${missingBlockers.join(', ')}`,
|
||||
'Keep publication blockers explicit until the live release, package, plugin, and billing surfaces exist.'
|
||||
),
|
||||
];
|
||||
|
||||
const failed = checks.filter(check => check.status !== 'pass');
|
||||
const digest = crypto
|
||||
.createHash('sha256')
|
||||
.update(JSON.stringify(checks.map(check => [check.id, check.status, check.evidence])))
|
||||
.digest('hex')
|
||||
.slice(0, 12);
|
||||
|
||||
return {
|
||||
schema_version: SCHEMA_VERSION,
|
||||
release: RELEASE,
|
||||
ready: failed.length === 0,
|
||||
digest,
|
||||
summary: {
|
||||
passed: checks.length - failed.length,
|
||||
failed: failed.length,
|
||||
total: checks.length,
|
||||
},
|
||||
checks,
|
||||
};
|
||||
}
|
||||
|
||||
function renderText(report) {
|
||||
const lines = [
|
||||
'ECC preview pack smoke',
|
||||
`Release: ${report.release}`,
|
||||
`Ready: ${report.ready ? 'yes' : 'no'}`,
|
||||
`Digest: ${report.digest}`,
|
||||
'',
|
||||
'Checks:',
|
||||
];
|
||||
|
||||
for (const check of report.checks) {
|
||||
lines.push(`- ${check.status} ${check.id}: ${check.evidence}`);
|
||||
if (check.fix) {
|
||||
lines.push(` fix: ${check.fix}`);
|
||||
}
|
||||
}
|
||||
|
||||
lines.push('');
|
||||
lines.push(`Passed: ${report.summary.passed}`);
|
||||
lines.push(`Failed: ${report.summary.failed}`);
|
||||
|
||||
return `${lines.join('\n')}\n`;
|
||||
}
|
||||
|
||||
function main() {
|
||||
let parsed;
|
||||
|
||||
try {
|
||||
parsed = parseArgs(process.argv);
|
||||
} catch (error) {
|
||||
console.error(`Error: ${error.message}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
if (parsed.help) {
|
||||
usage();
|
||||
return;
|
||||
}
|
||||
|
||||
const report = buildReport({ root: parsed.root });
|
||||
|
||||
if (parsed.format === 'json') {
|
||||
console.log(JSON.stringify(report, null, 2));
|
||||
} else {
|
||||
process.stdout.write(renderText(report));
|
||||
}
|
||||
|
||||
if (!report.ready) {
|
||||
process.exit(2);
|
||||
}
|
||||
}
|
||||
|
||||
if (require.main === module) {
|
||||
main();
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
REQUIRED_ARTIFACTS,
|
||||
REQUIRED_PUBLICATION_BLOCKERS,
|
||||
REQUIRED_VERIFICATION_COMMANDS,
|
||||
buildReport,
|
||||
parseArgs,
|
||||
renderText,
|
||||
};
|
||||
Reference in New Issue
Block a user