Phase 0b slice: monorepo scaffold + @sh-mcp/shared core + integration packages (#2)
* Phase 0b slice: monorepo scaffold + shared core + integration packages
The 0a-INDEPENDENT code slice (one-shot via af-0b-package-slice workflow: Haiku
scaffold + Sonnet packages, Sonnet fix-to-green). Nothing deploys; no CDK/servers.
- Monorepo scaffold: npm workspaces, strict TS (NodeNext), vitest (80% gate),
eslint 9 flat config, prettier; ci.yaml/deploy.yaml callers (Node 24, enable-qemu).
- @sh-mcp/shared: transport-agnostic core — Scope/AuthContext/ToolDef, ToolRegistry,
redact()+maskValue() (PII), OpenAPI 3.1 generator. AUTH STUBBED behind an AuthProvider
interface (TODO auth-layer-0a); JWT/aud/client_id/JWKS/deny-list deferred per design.md §2.
- 9 integration packages (qbo, google-maps, internal-data, payments, knowledge-base,
gmail, calendar, tasks, reminders): tools against shared, external deps mocked behind
injected client interfaces; finance handlers call redact().
Verified green: tsc -b clean, vitest 245/245, eslint 0 errors. Auth mechanism intentionally
deferred until the 0a spike resolves it (G16/§0.4).
* Complete Cognito auth provider + Phase 1 build brief
Finish the WIP CognitoAuthProvider (client_id allow-list as audience
boundary, finance TTL ceiling, deny-list, scope-prefix stripping) with
its test suite, and check in docs/build-plan-phase-1.md so the Phase 1
work has its governing brief in-tree (design.md §2.5).
* ci: disable cdk synth for Phase 0b (no CDK app yet)
The reusable ci-typescript-cdk workflow defaults run-cdk-synth: true, but
the Phase 0b package scaffold has no cdk.json or stacks, so cdk synth fails
with '--app is required'. Disable it here; Phase 1 re-enables it with the
server CDK stubs.
2026-06-26 12:42:17 -04:00
|
|
|
import { describe, it, expect } from 'vitest';
|
|
|
|
|
import { redact, REDACTED } from './redact.js';
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
// SSN tests
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
describe('redact — SSN', () => {
|
|
|
|
|
it('masks canonical SSN (NNN-NN-NNNN)', () => {
|
|
|
|
|
expect(redact('SSN: 123-45-6789')).toContain(REDACTED);
|
|
|
|
|
expect(redact('SSN: 123-45-6789')).not.toContain('123-45-6789');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks spaced SSN (NNN NN NNNN)', () => {
|
|
|
|
|
const result = redact('Social security: 123 45 6789');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
expect(result).not.toContain('123 45 6789');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks bare 9-digit SSN after keyword', () => {
|
|
|
|
|
const result = redact('ssn 123456789');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
expect(result).not.toContain('123456789');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks SSN with "tax id" keyword', () => {
|
|
|
|
|
const result = redact('tax id: 123-45-6789');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('does NOT mask a bare 9-digit number without keyword', () => {
|
|
|
|
|
// Could be an invoice number, PO number, etc.
|
|
|
|
|
const result = redact('Invoice #987654321 is due.');
|
|
|
|
|
expect(result).not.toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('preserves surrounding text', () => {
|
|
|
|
|
const result = redact('Employee 123-45-6789 is John Smith.');
|
|
|
|
|
expect(result).toContain('Employee');
|
|
|
|
|
expect(result).toContain('John Smith');
|
|
|
|
|
expect(result).not.toContain('123-45-6789');
|
|
|
|
|
});
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
// Routing number tests
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
describe('redact — routing numbers', () => {
|
|
|
|
|
it('masks routing number with keyword before', () => {
|
|
|
|
|
const result = redact('routing number 021000021');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
expect(result).not.toContain('021000021');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks ABA number with keyword', () => {
|
|
|
|
|
const result = redact('ABA: 021000021');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
expect(result).not.toContain('021000021');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks routing number with keyword after (parenthetical)', () => {
|
|
|
|
|
const result = redact('021000021 (routing)');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
expect(result).not.toContain('021000021');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('does NOT mask a bare 9-digit number that is not a routing number', () => {
|
|
|
|
|
// Phone number fragment or zip+4 style — no keyword context
|
|
|
|
|
const result = redact('Ref: 123456789 approved.');
|
|
|
|
|
expect(result).not.toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('preserves vendor name next to routing number', () => {
|
|
|
|
|
const result = redact('Vendor: Acme Corp, routing number 021000021');
|
|
|
|
|
expect(result).toContain('Acme Corp');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
// Account number tests
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
describe('redact — account numbers', () => {
|
|
|
|
|
it('masks account number with keyword', () => {
|
|
|
|
|
const result = redact('account number 12345678');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
expect(result).not.toContain('12345678');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks acct # shorthand', () => {
|
|
|
|
|
const result = redact('acct #98765');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
expect(result).not.toContain('98765');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks account: prefix', () => {
|
|
|
|
|
const result = redact('Account: 1234567890123');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('does NOT mask invoice/PO numbers without account keyword', () => {
|
|
|
|
|
const result = redact('Invoice #12345 for Acme Corp');
|
|
|
|
|
expect(result).not.toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('does NOT mask numbers below 4 digits', () => {
|
|
|
|
|
const result = redact('account number 123');
|
|
|
|
|
// 3 digits is below the minimum — no match
|
|
|
|
|
expect(result).not.toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('preserves contact info adjacent to account number', () => {
|
Add security-weighted test suite + coverage gate; wire tooling
Add tests for the highest-risk surface (build-plan §5, design.md §7.3):
tool-hiding, server-side scope enforcement (incl. forced hidden calls),
audience binding, input-schema validation, finance redaction on egress, audit
emission with hashed args, prompt-injection regression (tool output is data),
rate limiting, MCP conformance (in-memory transport round-trip), OpenAPI 3.1
validity, and local-auth safety. Add HTTP integration tests (supertest) for both
servers and per-package dev-client tests. 405 tests pass.
Wire the coverage gate into vitest.config.ts: 80% overall, with per-file
thresholds on the auth + dispatch crown jewels; exclude deferred real client
stubs, entrypoints, cdk apps, and aws-only config from the gate (documented).
Extend eslint flat config + add .prettierignore to cover servers/. Commit the
updated package-lock.json.
2026-06-24 20:42:41 -04:00
|
|
|
const result = redact('Contact billing@acme.com for account number 987654321');
|
Phase 0b slice: monorepo scaffold + @sh-mcp/shared core + integration packages (#2)
* Phase 0b slice: monorepo scaffold + shared core + integration packages
The 0a-INDEPENDENT code slice (one-shot via af-0b-package-slice workflow: Haiku
scaffold + Sonnet packages, Sonnet fix-to-green). Nothing deploys; no CDK/servers.
- Monorepo scaffold: npm workspaces, strict TS (NodeNext), vitest (80% gate),
eslint 9 flat config, prettier; ci.yaml/deploy.yaml callers (Node 24, enable-qemu).
- @sh-mcp/shared: transport-agnostic core — Scope/AuthContext/ToolDef, ToolRegistry,
redact()+maskValue() (PII), OpenAPI 3.1 generator. AUTH STUBBED behind an AuthProvider
interface (TODO auth-layer-0a); JWT/aud/client_id/JWKS/deny-list deferred per design.md §2.
- 9 integration packages (qbo, google-maps, internal-data, payments, knowledge-base,
gmail, calendar, tasks, reminders): tools against shared, external deps mocked behind
injected client interfaces; finance handlers call redact().
Verified green: tsc -b clean, vitest 245/245, eslint 0 errors. Auth mechanism intentionally
deferred until the 0a spike resolves it (G16/§0.4).
* Complete Cognito auth provider + Phase 1 build brief
Finish the WIP CognitoAuthProvider (client_id allow-list as audience
boundary, finance TTL ceiling, deny-list, scope-prefix stripping) with
its test suite, and check in docs/build-plan-phase-1.md so the Phase 1
work has its governing brief in-tree (design.md §2.5).
* ci: disable cdk synth for Phase 0b (no CDK app yet)
The reusable ci-typescript-cdk workflow defaults run-cdk-synth: true, but
the Phase 0b package scaffold has no cdk.json or stacks, so cdk synth fails
with '--app is required'. Disable it here; Phase 1 re-enables it with the
server CDK stubs.
2026-06-26 12:42:17 -04:00
|
|
|
expect(result).toContain('billing@acme.com');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
// Card number tests
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
describe('redact — card numbers', () => {
|
|
|
|
|
it('masks a valid 16-digit Visa card number', () => {
|
|
|
|
|
// 4111111111111111 is the canonical Luhn-valid test card
|
|
|
|
|
const result = redact('Card: 4111111111111111');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
expect(result).not.toContain('4111111111111111');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks a hyphen-separated card number', () => {
|
|
|
|
|
const result = redact('Card: 4111-1111-1111-1111');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks a space-separated card number', () => {
|
|
|
|
|
const result = redact('Card: 4111 1111 1111 1111');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('masks a valid 15-digit Amex number', () => {
|
|
|
|
|
// 378282246310005 is the canonical Amex test card
|
|
|
|
|
const result = redact('Amex: 378282246310005');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('does NOT mask a 16-digit number that fails Luhn', () => {
|
|
|
|
|
// 1234567890123456 fails Luhn
|
|
|
|
|
const result = redact('Value: 1234567890123456');
|
|
|
|
|
expect(result).not.toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('does NOT mask phone numbers (10 digits, fail Luhn)', () => {
|
|
|
|
|
const result = redact('Call us at 5551234567');
|
|
|
|
|
// 10 digits is below the 13-digit minimum for card pattern
|
|
|
|
|
expect(result).not.toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('preserves vendor name next to card number', () => {
|
|
|
|
|
const result = redact('Charged Stripe account for 4111111111111111');
|
|
|
|
|
expect(result).toContain('Stripe');
|
|
|
|
|
expect(result).toContain(REDACTED);
|
|
|
|
|
});
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
// Vendor names and contacts left intact
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
describe('redact — preserves vendor names and contacts', () => {
|
|
|
|
|
it('leaves company names intact', () => {
|
|
|
|
|
const result = redact('Vendor: Consolidated Edison Co.');
|
|
|
|
|
expect(result).toBe('Vendor: Consolidated Edison Co.');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('leaves email addresses intact', () => {
|
|
|
|
|
const result = redact('Contact: billing@acmecorp.com');
|
|
|
|
|
expect(result).toBe('Contact: billing@acmecorp.com');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('leaves phone numbers intact', () => {
|
|
|
|
|
// Standard US phone — 10 digits, below card threshold
|
|
|
|
|
const result = redact('Phone: 212-555-0100');
|
|
|
|
|
expect(result).toBe('Phone: 212-555-0100');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('leaves street addresses intact', () => {
|
|
|
|
|
const result = redact('123 Main Street, New York, NY 10001');
|
|
|
|
|
expect(result).toBe('123 Main Street, New York, NY 10001');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('leaves dollar amounts intact', () => {
|
|
|
|
|
const result = redact('Invoice total: $1,234.56');
|
|
|
|
|
expect(result).toBe('Invoice total: $1,234.56');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('leaves invoice and PO numbers intact', () => {
|
|
|
|
|
const result = redact('PO #20240001, Invoice #INV-9999');
|
|
|
|
|
expect(result).toBe('PO #20240001, Invoice #INV-9999');
|
|
|
|
|
});
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
// Mixed / realistic finance response
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
describe('redact — realistic finance responses', () => {
|
|
|
|
|
it('masks multiple sensitive fields in a payment record', () => {
|
|
|
|
|
const payload = [
|
|
|
|
|
'Vendor: Acme Supply Co.',
|
|
|
|
|
'Contact: accounts@acme.com',
|
|
|
|
|
'Bank routing: 021000021',
|
|
|
|
|
'Account number: 123456789012',
|
|
|
|
|
'Check amount: $4,500.00',
|
|
|
|
|
'Employee SSN: 123-45-6789',
|
|
|
|
|
].join('\n');
|
|
|
|
|
|
|
|
|
|
const result = redact(payload);
|
|
|
|
|
|
|
|
|
|
// Sensitive fields masked
|
|
|
|
|
expect(result).not.toContain('021000021');
|
|
|
|
|
expect(result).not.toContain('123456789012');
|
|
|
|
|
expect(result).not.toContain('123-45-6789');
|
|
|
|
|
|
|
|
|
|
// Vendor name and contact intact
|
|
|
|
|
expect(result).toContain('Acme Supply Co.');
|
|
|
|
|
expect(result).toContain('accounts@acme.com');
|
|
|
|
|
|
|
|
|
|
// Dollar amount intact
|
|
|
|
|
expect(result).toContain('$4,500.00');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('is idempotent — redacting twice produces the same result', () => {
|
|
|
|
|
const payload = 'SSN: 987-65-4321, routing number 021000021';
|
|
|
|
|
const once = redact(payload);
|
|
|
|
|
const twice = redact(once);
|
|
|
|
|
expect(once).toBe(twice);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('handles empty string without error', () => {
|
|
|
|
|
expect(redact('')).toBe('');
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('handles string with no sensitive data unchanged', () => {
|
|
|
|
|
const clean = 'Lookup result: work order WO-12345 for site Central Park.';
|
|
|
|
|
expect(redact(clean)).toBe(clean);
|
|
|
|
|
});
|
|
|
|
|
});
|