coder-xieshijie/dev-skills / skills/repo-readiness/assets/verify-skill
verify-<app>
FlaggedStarts isolated <app> instances, drives them through <entry points> and reports one result per sub-feature and entry with evidence. Use when verifying a change, reproducing a bug, or running, writing or checking feature maps and their scenario scripts.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.7 KB |
| features/README.md | markdown | 1.4 KB |
| references/maps.md | markdown | 11.4 KB |
| scripts/config.mjs | script | 5.2 KB |
| scripts/contract.mjs | script | 16.6 KB |
| scripts/map-check.mjs | script | 22.2 KB |
| scripts/primitives.mjs | script | 7.2 KB |
| scripts/runner.mjs | script | 24.0 KB |
| scripts/test/contract-check.test.mjs | script | 3.7 KB |
| scripts/test/contract.test.mjs | script | 1.4 KB |
| scripts/test/fixture/notes-entry.mjs | script | 3.5 KB |
| scripts/test/fixture/proc-app.mjs | script | 1.3 KB |
| scripts/test/fixture/proc-entry.mjs | script | 5.5 KB |
| scripts/test/fixture/web-entry.mjs | script | 535 B |
| scripts/test/helpers.mjs | script | 5.0 KB |
| scripts/test/map-check.test.mjs | script | 9.5 KB |
| scripts/test/primitives.test.mjs | script | 4.1 KB |
| scripts/test/runner.test.mjs | script | 17.3 KB |
| scripts/verify.mjs | script | 9.7 KB |
| verify.config.json | config | 1016 B |
scripts/test/contract-check.test.mjs
View on GitHub// The contract checker's own tests: a stand-in adapter that keeps the contract passes, and each fault
// in fixture/proc-entry.mjs fails the one check meant to catch it.
import assert from 'node:assert/strict';
import path from 'node:path';
import test from 'node:test';
import { fileURLToPath } from 'node:url';
import { checkContract } from '../contract.mjs';
import { makeRepo } from './helpers.mjs';
const here = path.dirname(fileURLToPath(import.meta.url));
const ENTRY = path.join(here, 'fixture', 'proc-entry.mjs');
async function contractOf({ faults = [], contract = { read: ['value'], leaves: ['spawn'] }, adapter = ENTRY } = {}) {
const repo = makeRepo({ config: { entries: { proc: { name: 'Proc', adapter, options: { faults }, contract } } } });
const result = await checkContract({ config: repo.config, slug: 'proc' });
return { result, failed: result.checks.filter((check) => !check.skipped && !check.ok).map((check) => check.name) };
}
test('an adapter that keeps the contract passes every check', async () => {
const { result, failed } = await contractOf();
assert.deepEqual(failed, []);
assert.equal(result.ok, true);
assert.deepEqual(result.checks.filter((check) => check.skipped), []);
});
const caught = {
'no-identity': "doctor is not ok when another instance answers on the instance's port",
'doctor-constant': 'doctor is not ok on a stopped instance',
'kill-by-name': 'down stops only its own instance: the other instance and an unrelated process keep running',
'keep-data': 'down removes the data directory',
'no-kept': 'down keeps evidence: kept names real paths that exist outside the data directory',
'twice-throws': 'a second down is ok',
'leave-children': 'nothing of the instance is left running after down',
'real-home': 'HOME is inside the data directory',
'leak-env': "a variable in the caller's environment does not reach the instance's processes",
'symlink-paths': 'every path in the instance is a real path',
'read-bypass': 'do value goes through ctx.read',
'not-serializable': 'the instance is JSON-serializable',
};
for (const [fault, check] of Object.entries(caught))
test(`counterexample ${fault}: "${check}" fails`, async () => {
const { result, failed } = await contractOf({ faults: [fault] });
assert.equal(result.ok, false);
assert.ok(failed.includes(check), JSON.stringify(failed));
});
test('HOME inherited on purpose passes only with a reason', async () => {
const declared = await contractOf({ faults: ['real-home'], contract: { read: ['value'], leaves: ['spawn'], inherits: { HOME: 'the product reads ~/.ssh' } } });
assert.deepEqual(declared.failed, []);
assert.ok(declared.result.checks.some((check) => check.skipped?.startsWith('inherited on purpose')));
const bare = await contractOf({ faults: ['real-home'], contract: { read: ['value'], inherits: { HOME: '' } } });
assert.ok(bare.failed.includes('HOME is inside the data directory'));
});
test('a missing read, a missing doctor check, a broken adapter and a skipped entry', async () => {
assert.ok((await contractOf({ contract: {} })).failed.includes('do <a read> goes through ctx.read'));
const named = await contractOf({ contract: { read: ['value'], doctorChecks: ['effective config matches'] } });
assert.deepEqual(named.failed, ['doctor checks "effective config matches"']);
const broken = await contractOf({ adapter: path.join(here, 'helpers.mjs') });
assert.deepEqual(broken.failed, ['exports up, doctor, down and tools as functions (sideEffect and capture too, when exported)']);
const skipped = await contractOf({ contract: { skip: 'needs a display' } });
assert.deepEqual(skipped.result, { ok: true, entry: 'proc', skipped: 'needs a display', checks: [] });
});
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |