Exemple
debug 4.3.7
Échantillon vérifié pour npm debug 4.3.7. Le contrat s'est exécuté sur node 22 · linux alpine/x64 · docker et a réussi : debug creates namespaced loggers and…
sha256:9d5f995b08e2b1a4e37460cd26604aa1ed33a9419a6d593a3e4386f2aff4833a
Ce réseau offre une seule chose : un échantillon qui compile. Il l'a exécuté dans un bac à sable et conservé le reçu signé. Il ne note rien et ne garantit rien : si le même code compile chez vous, il ne l'a pas mesuré.
Combien de clés de signature distinctes ont déposé un reçu de contrat réussi. Une seule, c'est l'auteur ; plus d'une signifie que quelqu'un d'autre l'a compilé aussi. Une clé est auto-générée sans identité enregistrée derrière, donc on compte des clés, pas des personnes.
MIT-0
Preuves d'exécution
L'environnement déclaré et les exécutions signées sont séparés, pour que vous voyiez exactement ce que cet échantillon a exécuté et où.
- Base de preuve
- Contrat signé réussi
- Reçus de vérification
- 1
- Clés de signature qui l’ont compilé
- 1
Environnement déclaré
linux 24 · ubuntu · glibc 2.39 x64 npm
Environnements des exécutions de vérification
| Environnement | Contrat | Étapes | Exécution |
|---|---|---|---|
| node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · node-typescript@1 |
2026-08-20 |
Cas
HOW- Objectif
- verify pkg:npm/debug@4.3.7
- Paquets
- Créé
- 2026-08-19T17:29:00Z
Contrat
- debug creates namespaced loggers and dynamically enables or disables matching patterns
- debug extend creates hierarchical child loggers with custom delimiters
- debug formatters allows custom argument formatters and output stream interception
Fichiers
- PROMPT.md
- csx.json
- package-lock.json
- package.json
- spec.json
- src/index.mjs
- test/contract.mjs
Code source
Clean-room public code sample — generation instructions
Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.
A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.
Goal: verify pkg:npm/debug@4.3.7
Kind: HOW
Use EXACTLY these public packages and versions:
- pkg:npm/debug@4.3.7
Rules:
- One focused purpose; the smallest project that proves the goal.
- Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
- Pin every dependency with a lockfile so resolution is reproducible.
- No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
- No personal names, emails, company names, or project identifiers of any kind.
- No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
- Keep it under 200 files and 256KB packed.
{"case":{"caseId":"case:sha256:1ede214d11da13cd36bc748d43780775d1aa1e6e0689be71a6f24c87d88809fa","contract":["debug creates namespaced loggers and dynamically enables or disables matching patterns","debug extend creates hierarchical child loggers with custom delimiters","debug formatters allows custom argument formatters and output stream interception"],"goal":"verify pkg:npm/debug@4.3.7","kind":"HOW","packages":["pkg:npm/debug@4.3.7"],"schemaVersion":1},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/debug@4.3.7"],"schemaVersion":1,"verifierAdapter":"node-typescript@1"}
{
"name": "debug-sample",
"version": "1.0.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "debug-sample",
"version": "1.0.0",
"dependencies": {
"debug": "4.3.7"
}
},
"node_modules/debug": {
"version": "4.3.7",
"resolved": "https://registry.npmjs.org/debug/-/debug-4.3.7.tgz",
"integrity": "sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ==",
"license": "MIT",
"dependencies": {
"ms": "^2.1.3"
},
"engines": {
"node": ">=6.0"
},
"peerDependenciesMeta": {
"supports-color": {
"optional": true
}
}
},
"node_modules/ms": {
"version": "2.1.3",
"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
"integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
"license": "MIT"
}
}
}
{
"name": "debug-sample",
"version": "1.0.0",
"type": "module",
"dependencies": {
"debug": "4.3.7"
}
}
{
"schemaVersion": 1,
"goal": "verify pkg:npm/debug@4.3.7",
"kind": "HOW",
"packages": [
"pkg:npm/debug@4.3.7"
]
}
import debug from 'debug';
/**
* Creates a debug logger instance for a given namespace.
*
* @param {string} namespace
* @returns {debug.Debugger}
*/
export function createLogger(namespace) {
return debug(namespace);
}
/**
* Enables namespaces matching the given pattern string.
*
* @param {string} namespaces
*/
export function enableNamespaces(namespaces) {
debug.enable(namespaces);
}
/**
* Disables all debug logging namespaces.
*
* @returns {string} The previously enabled namespaces string.
*/
export function disableNamespaces() {
return debug.disable();
}
/**
* Checks whether a given namespace is currently enabled.
*
* @param {string} namespace
* @returns {boolean}
*/
export function isNamespaceEnabled(namespace) {
return debug.enabled(namespace);
}
/**
* Extends an existing debug logger to create a child logger with hierarchical namespace.
*
* @param {debug.Debugger} parentLogger
* @param {string} subNamespace
* @param {string} [delimiter]
* @returns {debug.Debugger}
*/
export function extendLogger(parentLogger, subNamespace, delimiter) {
if (delimiter !== undefined) {
return parentLogger.extend(subNamespace, delimiter);
}
return parentLogger.extend(subNamespace);
}
/**
* Registers a custom format specifier on the global debug formatters.
*
* @param {string} identifier Single character formatter identifier (e.g. 'u', 'j').
* @param {(value: any) => string} formatterFn
*/
export function registerFormatter(identifier, formatterFn) {
debug.formatters[identifier] = formatterFn;
}
/**
* Captures log output produced by calling a callback with a logger.
*
* @param {debug.Debugger} logger
* @param {(log: debug.Debugger) => void} fn
* @returns {string[]}
*/
export function captureLogOutput(logger, fn) {
const originalLog = logger.log;
const captured = [];
try {
logger.log = (...args) => {
captured.push(args.join(' '));
};
fn(logger);
} finally {
logger.log = originalLog;
}
return captured;
}
import assert from 'node:assert/strict';
import {
createLogger,
enableNamespaces,
disableNamespaces,
isNamespaceEnabled,
extendLogger,
registerFormatter,
captureLogOutput,
} from '../src/index.mjs';
// Contract 1: debug creates namespaced loggers and dynamically enables or disables matching patterns
{
const logA = createLogger('app:http');
const logB = createLogger('app:db');
const logC = createLogger('worker:job');
assert.strictEqual(logA.namespace, 'app:http', 'logA should have namespace app:http');
assert.strictEqual(logB.namespace, 'app:db', 'logB should have namespace app:db');
assert.strictEqual(logC.namespace, 'worker:job', 'logC should have namespace worker:job');
// Enable app:* and exclude app:db
enableNamespaces('app:*,-app:db');
assert.strictEqual(isNamespaceEnabled('app:http'), true, 'app:http should be enabled');
assert.strictEqual(isNamespaceEnabled('app:db'), false, 'app:db should be disabled by exclusion');
assert.strictEqual(isNamespaceEnabled('worker:job'), false, 'worker:job should not match pattern');
assert.strictEqual(logA.enabled, true, 'logA instance should be enabled');
assert.strictEqual(logB.enabled, false, 'logB instance should be disabled');
// Disable all
const prev = disableNamespaces();
assert.strictEqual(prev, 'app:*,-app:db', 'disable should return previous namespaces string');
assert.strictEqual(isNamespaceEnabled('app:http'), false, 'app:http should now be disabled');
}
// Contract 2: debug extend creates hierarchical child loggers with custom delimiters
{
enableNamespaces('server:*');
const serverLog = createLogger('server');
const authLog = extendLogger(serverLog, 'auth');
const sessionLog = extendLogger(authLog, 'session');
assert.strictEqual(authLog.namespace, 'server:auth', 'Child namespace should be server:auth');
assert.strictEqual(sessionLog.namespace, 'server:auth:session', 'Nested child namespace should be server:auth:session');
assert.strictEqual(authLog.enabled, true, 'Extended logger should be enabled under server:*');
assert.strictEqual(sessionLog.enabled, true, 'Nested extended logger should be enabled under server:*');
// Custom delimiter
const customDelimLog = extendLogger(serverLog, 'metrics', '/');
assert.strictEqual(customDelimLog.namespace, 'server/metrics', 'Custom delimiter / should be used in namespace');
}
// Contract 3: debug formatters allows custom argument formatters and output stream interception
{
enableNamespaces('test:formatter');
const testLog = createLogger('test:formatter');
// Register custom uppercase formatter %u
registerFormatter('u', (val) => String(val).toUpperCase());
const messages = captureLogOutput(testLog, (log) => {
log('processing item %u with id %d', 'alpha', 42);
});
assert.strictEqual(messages.length, 1, 'Should capture exactly 1 log line');
assert.ok(messages[0].includes('ALPHA'), 'Custom formatter %u should uppercase input to ALPHA');
assert.ok(messages[0].includes('42'), 'Standard %d formatter should format number 42');
assert.ok(messages[0].includes('test:formatter'), 'Log line should contain the logger namespace');
}
console.log('All pkg:npm/debug@4.3.7 contract tests passed successfully.');
Seeder d'origine
anonyme