@aperant/framework 0.6.2

package/dist/__tests__/personas-frontmatter.test.d.ts

@@ -0,0 +1,24 @@
+/**
+ * personas-frontmatter.test.ts — C48 dogfood of the x-* custom-intent path.
+ *
+ * apt:personas is the first shipping skill with a custom intent
+ * (`intent: x-personas`). The router-0.3.0 redesign introduced the x-*
+ * extension path with a promise: any skill author can ship a vertical-
+ * specific intent without amending CORE_INTENTS, as long as it matches
+ * CUSTOM_INTENT_REGEX (`^x-[a-z][a-z0-9-]*$`).
+ *
+ * This file is that promise in executable form:
+ *   - the shipping SKILL.md validates against the Zod schema end-to-end;
+ *   - the fat-frontmatter keys (stage, intent, when_to_use,
+ *     user_invocable, internal, spawns_agent, agent_name, allowed-tools,
+ *     argument-hint, gates, default_execution_mode, execution_modes) are
+ *     populated to known-good values;
+ *   - `apt-tools check` (via runCheck) accepts the skill without errors
+ *     — the first CLI-level assertion that the x-* path works against
+ *     the live gate registry + real schema.
+ *
+ * If the host LLM ever drops `intent: x-personas` during a template
+ * migration, this file fails loud and the next router release is blocked.
+ */
+export {};
+//# sourceMappingURL=personas-frontmatter.test.d.ts.map

package/dist/__tests__/personas-frontmatter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas-frontmatter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/personas-frontmatter.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/__tests__/personas-frontmatter.test.js

@@ -0,0 +1,108 @@
+/**
+ * personas-frontmatter.test.ts — C48 dogfood of the x-* custom-intent path.
+ *
+ * apt:personas is the first shipping skill with a custom intent
+ * (`intent: x-personas`). The router-0.3.0 redesign introduced the x-*
+ * extension path with a promise: any skill author can ship a vertical-
+ * specific intent without amending CORE_INTENTS, as long as it matches
+ * CUSTOM_INTENT_REGEX (`^x-[a-z][a-z0-9-]*$`).
+ *
+ * This file is that promise in executable form:
+ *   - the shipping SKILL.md validates against the Zod schema end-to-end;
+ *   - the fat-frontmatter keys (stage, intent, when_to_use,
+ *     user_invocable, internal, spawns_agent, agent_name, allowed-tools,
+ *     argument-hint, gates, default_execution_mode, execution_modes) are
+ *     populated to known-good values;
+ *   - `apt-tools check` (via runCheck) accepts the skill without errors
+ *     — the first CLI-level assertion that the x-* path works against
+ *     the live gate registry + real schema.
+ *
+ * If the host LLM ever drops `intent: x-personas` during a template
+ * migration, this file fails loud and the next router release is blocked.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { parse as parseYaml } from 'yaml';
+import { runCheck } from '../cli/commands/check.mjs';
+import { CORE_INTENTS, CUSTOM_INTENT_REGEX, SkillFrontmatterSchema, } from '../cli/skill-author/contract.mjs';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SKILL_PATH = resolve(__dirname, '..', '..', 'skills', 'apt-personas', 'SKILL.md');
+const SKILLS_ROOT = resolve(__dirname, '..', '..', 'skills');
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n/;
+function extractFrontmatter(text) {
+    const m = text.match(FRONTMATTER_RE);
+    if (!m)
+        return null;
+    const parsed = parseYaml(m[1]);
+    if (parsed !== null && typeof parsed === 'object')
+        return parsed;
+    return null;
+}
+describe('apt-personas SKILL.md — x-personas custom intent dogfood', () => {
+    it('SKILL.md exists and parses frontmatter', () => {
+        const raw = readFileSync(SKILL_PATH, 'utf-8');
+        const fm = extractFrontmatter(raw);
+        expect(fm).not.toBeNull();
+    });
+    it('declares intent: x-personas (not a core intent)', () => {
+        const raw = readFileSync(SKILL_PATH, 'utf-8');
+        const fm = extractFrontmatter(raw);
+        expect(fm.intent).toBe('x-personas');
+        // Must NOT be in core — defeats the point otherwise.
+        expect(CORE_INTENTS.includes(fm.intent)).toBe(false);
+        // Must match the custom-intent regex.
+        expect(CUSTOM_INTENT_REGEX.test(fm.intent)).toBe(true);
+    });
+    it('has the fat-frontmatter shape expected by the 0.3.0 router', () => {
+        const raw = readFileSync(SKILL_PATH, 'utf-8');
+        const fm = extractFrontmatter(raw);
+        for (const key of [
+            'name',
+            'description',
+            'stage',
+            'intent',
+            'when_to_use',
+            'user_invocable',
+            'internal',
+            'spawns_agent',
+            'agent_name',
+            'allowed-tools',
+            'argument-hint',
+            'gates',
+            'default_execution_mode',
+            'execution_modes',
+        ]) {
+            expect(fm[key], `missing frontmatter key: ${key}`).toBeDefined();
+        }
+    });
+    it('validates cleanly against SkillFrontmatterSchema (Zod)', () => {
+        const raw = readFileSync(SKILL_PATH, 'utf-8');
+        const fm = extractFrontmatter(raw);
+        const res = SkillFrontmatterSchema.safeParse(fm);
+        if (!res.success) {
+            const issues = res.error.issues
+                .map((i) => `  ${i.path.join('.') || '(root)'}: ${i.message}`)
+                .join('\n');
+            throw new Error(`apt-personas SKILL.md failed schema validation:\n${issues}`);
+        }
+    });
+    it('has user_invocable=true, internal=false, and non-agent stance', () => {
+        const raw = readFileSync(SKILL_PATH, 'utf-8');
+        const fm = extractFrontmatter(raw);
+        expect(fm.user_invocable).toBe(true);
+        expect(fm.internal).toBe(false);
+        expect(fm.spawns_agent).toBe(false);
+        expect(fm.agent_name).toBe(null);
+    });
+    it('apt-tools check accepts the whole skill set (x-personas does not break the registry)', () => {
+        const result = runCheck({ skillsRoot: SKILLS_ROOT });
+        if (result.status !== 'ok') {
+            const errors = result.errors.map((e) => `  ${e.file} ${e.field}: ${e.message}`).join('\n');
+            throw new Error(`apt-tools check failed — x-personas introduced a regression:\n${errors}`);
+        }
+        expect(result.status).toBe('ok');
+    });
+});
+//# sourceMappingURL=personas-frontmatter.test.js.map

package/dist/__tests__/personas-frontmatter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas-frontmatter.test.js","sourceRoot":"","sources":["../../src/__tests__/personas-frontmatter.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/personas-role-scan.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * personas-role-scan.test.ts — C48 deterministic role-signal scan.
+ *
+ * The scan is the "code signal" half of the D-05 tier rubric: without it,
+ * the LLM drafts personas from prose alone and tier assignments become
+ * unfalsifiable. This test pins the four detection kinds (identifier,
+ * route-prefix, rbac-pattern, validator-enum), the bounded-sample contract
+ * (fileCap/lineCap), and the unique_role_strings shortlist the SKILL.md
+ * body uses to seed its persona drafts.
+ *
+ * No LLM calls under test — the scan is pure text-pattern matching.
+ */
+export {};
+//# sourceMappingURL=personas-role-scan.test.d.ts.map

package/dist/__tests__/personas-role-scan.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas-role-scan.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/personas-role-scan.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/__tests__/personas-role-scan.test.js

@@ -0,0 +1,134 @@
+/**
+ * personas-role-scan.test.ts — C48 deterministic role-signal scan.
+ *
+ * The scan is the "code signal" half of the D-05 tier rubric: without it,
+ * the LLM drafts personas from prose alone and tier assignments become
+ * unfalsifiable. This test pins the four detection kinds (identifier,
+ * route-prefix, rbac-pattern, validator-enum), the bounded-sample contract
+ * (fileCap/lineCap), and the unique_role_strings shortlist the SKILL.md
+ * body uses to seed its persona drafts.
+ *
+ * No LLM calls under test — the scan is pure text-pattern matching.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runRoleScan } from '../cli/personas/role-scan.mjs';
+let root;
+beforeEach(() => {
+    root = mkdtempSync(join(tmpdir(), 'apt-c48-role-scan-'));
+});
+afterEach(() => {
+    try {
+        rmSync(root, { recursive: true, force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+});
+function writeFile(relPath, body) {
+    const abs = join(root, relPath);
+    mkdirSync(join(root, relPath, '..'), { recursive: true });
+    writeFileSync(abs, body, 'utf-8');
+}
+describe('runRoleScan — kind detection', () => {
+    it('detects identifier signals (isAdmin / userRole)', () => {
+        writeFile('apps/web/auth.ts', [
+            'export function guard(user: User) {',
+            '  if (user.isAdmin) return "admin"',
+            '  return userRole(user)',
+            '}',
+        ].join('\n'));
+        const res = runRoleScan(root);
+        const kinds = res.findings.map((f) => f.kind);
+        expect(kinds).toContain('identifier');
+    });
+    it('detects route-prefix signals (/api/admin, /coach/)', () => {
+        writeFile('apps/web/api.ts', "const routes = ['/api/admin/users', '/coach/dashboard']");
+        const res = runRoleScan(root);
+        const prefixes = res.findings.filter((f) => f.kind === 'route-prefix');
+        expect(prefixes.length).toBeGreaterThan(0);
+    });
+    it('detects rbac-pattern signals (Role, hasPermission)', () => {
+        writeFile('packages/core/rbac.ts', [
+            'export function can(user: User, permission: Permission) {',
+            '  return hasRole(user, Role.Admin) && hasPermission(user, permission)',
+            '}',
+        ].join('\n'));
+        const res = runRoleScan(root);
+        const rbac = res.findings.filter((f) => f.kind === 'rbac-pattern');
+        expect(rbac.length).toBeGreaterThan(0);
+    });
+    it('detects validator-enum signals (z.enum / v.literal)', () => {
+        writeFile('packages/backend/schema.ts', [
+            'import { z } from "zod"',
+            'const RoleSchema = z.enum(["admin", "coach", "user"])',
+            'const role = v.literal("teacher")',
+        ].join('\n'));
+        const res = runRoleScan(root);
+        const enums = res.findings.filter((f) => f.kind === 'validator-enum');
+        expect(enums.length).toBeGreaterThanOrEqual(3);
+        expect(res.unique_role_strings).toEqual(expect.arrayContaining(['admin', 'coach', 'user']));
+        expect(res.unique_role_strings).toContain('teacher');
+    });
+    it('ignores rbac-pattern matches inside line comments', () => {
+        writeFile('packages/core/rbac.ts', [
+            '// hasRole is called from requireAuth below',
+            'export function actual() { return true }',
+        ].join('\n'));
+        const res = runRoleScan(root);
+        const rbac = res.findings.filter((f) => f.kind === 'rbac-pattern');
+        expect(rbac.length).toBe(0);
+    });
+});
+describe('runRoleScan — boundaries + empty case', () => {
+    it('returns empty findings on a dir with zero source files', () => {
+        writeFile('README.md', '# Just a readme');
+        const res = runRoleScan(root);
+        expect(res.files_scanned).toBe(0);
+        expect(res.findings).toEqual([]);
+        expect(res.unique_role_strings).toEqual([]);
+    });
+    it('returns ok-shape when the project dir does not exist', () => {
+        const res = runRoleScan(join(root, 'nonexistent-subdir'));
+        expect(res.files_scanned).toBe(0);
+        expect(res.findings).toEqual([]);
+        expect(res.limits.reason).toMatch(/missing|not a directory/);
+    });
+    it('skips node_modules and .git and dist', () => {
+        // Will be scanned:
+        writeFile('src/a.ts', 'const userRole = "admin"');
+        // Will be skipped:
+        writeFile('node_modules/pkg/foo.ts', 'const userRole = "ignored"');
+        writeFile('.git/hooks/pre-commit.ts', 'const userRole = "ignored"');
+        writeFile('dist/bundle.ts', 'const userRole = "ignored"');
+        const res = runRoleScan(root);
+        const files = new Set(res.findings.map((f) => f.file));
+        expect(files.has('src/a.ts')).toBe(true);
+        for (const f of files) {
+            expect(f.startsWith('node_modules/')).toBe(false);
+            expect(f.startsWith('.git/')).toBe(false);
+            expect(f.startsWith('dist/')).toBe(false);
+        }
+    });
+    it('honors fileCap limit', () => {
+        for (let i = 0; i < 10; i++) {
+            writeFile(`src/file${i}.ts`, `const userRole = "admin${i}"`);
+        }
+        const res = runRoleScan(root, { fileCap: 3 });
+        expect(res.files_scanned).toBeLessThanOrEqual(3);
+        expect(res.limits.truncated).toBe(true);
+    });
+});
+describe('runRoleScan — unique_role_strings shortlist', () => {
+    it('de-dupes and sorts role strings from high-signal findings', () => {
+        writeFile('packages/backend/schema.ts', [
+            'const R = z.enum(["admin", "user", "coach", "admin"])',
+            'const duplicate = v.literal("coach")',
+        ].join('\n'));
+        const res = runRoleScan(root);
+        expect(res.unique_role_strings).toEqual(['admin', 'coach', 'user']);
+    });
+});
+//# sourceMappingURL=personas-role-scan.test.js.map

package/dist/__tests__/personas-role-scan.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas-role-scan.test.js","sourceRoot":"","sources":["../../src/__tests__/personas-role-scan.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/personas-schema-roundtrip.test.d.ts

@@ -0,0 +1,31 @@
+/**
+ * personas-schema-roundtrip.test.ts — C48 D-04 schema-extraction contract.
+ *
+ * Pins the cross-package contract: the build-time
+ * `packages/framework/scripts/extract-personas-schema.mjs` must produce a
+ * JSON Schema artifact at `packages/framework/templates/personas-schema.json`
+ * whose shape matches the canonical DDL in
+ * `packages/core/src/storage/schema.ts`.
+ *
+ * Rather than hardcoding column lists (which would drift the moment
+ * someone adds a column to `personas` in core), this test re-runs the
+ * extractor in a tmp output dir and compares the generated schema's
+ * required-column set to what the DDL actually declares. If the two
+ * disagree, the extractor has drifted from the source of truth and the
+ * test fails — forcing the contributor to update the extractor rather
+ * than silently shipping a stale schema.
+ *
+ * Also asserts:
+ *   - the envelope exposes the three row definitions (Persona,
+ *     PersonaDiscoveryRun, PersonaCandidate) plus the two wrapper shapes
+ *     (FrameworkPersonasFile, FrameworkPersonasRunsFile) — every C48 D-01
+ *     consumer relies on this surface;
+ *   - a framework-shaped personas.json envelope validates against the
+ *     extracted schema (dogfood of D-04's claim that the schema is
+ *     actually usable at runtime);
+ *   - the extractor is deterministic — running it twice produces
+ *     byte-identical output (so CI can diff against the checked-in
+ *     artifact without flake).
+ */
+export {};
+//# sourceMappingURL=personas-schema-roundtrip.test.d.ts.map

package/dist/__tests__/personas-schema-roundtrip.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas-schema-roundtrip.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/personas-schema-roundtrip.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/dist/__tests__/personas-schema-roundtrip.test.js

@@ -0,0 +1,235 @@
+/**
+ * personas-schema-roundtrip.test.ts — C48 D-04 schema-extraction contract.
+ *
+ * Pins the cross-package contract: the build-time
+ * `packages/framework/scripts/extract-personas-schema.mjs` must produce a
+ * JSON Schema artifact at `packages/framework/templates/personas-schema.json`
+ * whose shape matches the canonical DDL in
+ * `packages/core/src/storage/schema.ts`.
+ *
+ * Rather than hardcoding column lists (which would drift the moment
+ * someone adds a column to `personas` in core), this test re-runs the
+ * extractor in a tmp output dir and compares the generated schema's
+ * required-column set to what the DDL actually declares. If the two
+ * disagree, the extractor has drifted from the source of truth and the
+ * test fails — forcing the contributor to update the extractor rather
+ * than silently shipping a stale schema.
+ *
+ * Also asserts:
+ *   - the envelope exposes the three row definitions (Persona,
+ *     PersonaDiscoveryRun, PersonaCandidate) plus the two wrapper shapes
+ *     (FrameworkPersonasFile, FrameworkPersonasRunsFile) — every C48 D-01
+ *     consumer relies on this surface;
+ *   - a framework-shaped personas.json envelope validates against the
+ *     extracted schema (dogfood of D-04's claim that the schema is
+ *     actually usable at runtime);
+ *   - the extractor is deterministic — running it twice produces
+ *     byte-identical output (so CI can diff against the checked-in
+ *     artifact without flake).
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const FRAMEWORK_ROOT = resolve(__dirname, '..', '..');
+const REPO_ROOT = resolve(FRAMEWORK_ROOT, '..', '..');
+const EXTRACTOR = resolve(FRAMEWORK_ROOT, 'scripts', 'extract-personas-schema.mjs');
+const SCHEMA_ARTIFACT = resolve(FRAMEWORK_ROOT, 'templates', 'personas-schema.json');
+const CORE_SCHEMA_TS = resolve(REPO_ROOT, 'packages', 'core', 'src', 'storage', 'schema.ts');
+function readArtifact() {
+    const text = readFileSync(SCHEMA_ARTIFACT, 'utf-8');
+    return JSON.parse(text);
+}
+/**
+ * Extract the body of a named DDL backtick-template from schema.ts — same
+ * shape as the extractor's internal helper, reimplemented here so the test
+ * is a true independent check rather than a circular one.
+ */
+function extractDdl(source, key) {
+    const re = new RegExp(`\\b${key}:\\s*\`([^\`]+)\``);
+    const m = re.exec(source);
+    return m ? m[1] : null;
+}
+/**
+ * Lift every column name that is NOT NULL and has NO DEFAULT out of a
+ * DDL body — the independent oracle for "required at write time".
+ */
+function requiredColumnsFromDdl(ddl) {
+    const openParen = ddl.indexOf('(');
+    const closeParen = ddl.lastIndexOf(')');
+    const body = ddl.slice(openParen + 1, closeParen);
+    const out = new Set();
+    let depth = 0;
+    let buf = '';
+    const lines = [];
+    for (const ch of body) {
+        if (ch === '(')
+            depth += 1;
+        else if (ch === ')')
+            depth = Math.max(0, depth - 1);
+        if (ch === ',' && depth === 0) {
+            lines.push(buf.trim());
+            buf = '';
+        }
+        else {
+            buf += ch;
+        }
+    }
+    if (buf.trim().length > 0)
+        lines.push(buf.trim());
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        if (/^\s*(FOREIGN KEY|PRIMARY KEY|UNIQUE|CHECK)\b/i.test(line))
+            continue;
+        const nameMatch = /^([a-zA-Z_][a-zA-Z0-9_]*)\s+/.exec(line);
+        if (!nameMatch)
+            continue;
+        const name = nameMatch[1];
+        const notNull = /\bNOT NULL\b/i.test(line);
+        const hasDefault = /\bDEFAULT\b/i.test(line);
+        if (notNull && !hasDefault)
+            out.add(name);
+    }
+    return out;
+}
+describe('personas-schema-roundtrip — C48 D-04 cross-package contract', () => {
+    it('artifact exists at the expected path', () => {
+        // The extractor is wired into `pnpm build`; in CI + local dev a build
+        // will have been run before the test suite. We also re-run it below
+        // to catch drift, but the artifact should always be checked in.
+        expect(existsSync(SCHEMA_ARTIFACT)).toBe(true);
+    });
+    it('exposes the five documented top-level definitions', () => {
+        const schema = readArtifact();
+        expect(schema.definitions).toBeDefined();
+        expect(Object.keys(schema.definitions).sort()).toEqual([
+            'FrameworkPersonasFile',
+            'FrameworkPersonasRunsFile',
+            'Persona',
+            'PersonaCandidate',
+            'PersonaDiscoveryRun',
+            'PersonaEvidenceAnchor',
+        ].sort());
+    });
+    it('Persona.required mirrors the NOT-NULL-no-default columns in personas DDL', () => {
+        const source = readFileSync(CORE_SCHEMA_TS, 'utf-8');
+        const ddl = extractDdl(source, 'personas');
+        expect(ddl).not.toBeNull();
+        const expectedRequired = requiredColumnsFromDdl(ddl);
+        const schema = readArtifact();
+        const actualRequired = new Set(schema.definitions.Persona.required ?? []);
+        expect([...actualRequired].sort()).toEqual([...expectedRequired].sort());
+        // Sanity: the set must include the four C48-load-bearing columns.
+        for (const col of ['team_id', 'project_id', 'ui_json', 'source_fingerprint']) {
+            expect(actualRequired.has(col)).toBe(true);
+        }
+    });
+    it('PersonaDiscoveryRun.required pins the D-09 run-tracking columns', () => {
+        const schema = readArtifact();
+        const req = new Set(schema.definitions.PersonaDiscoveryRun.required ?? []);
+        for (const col of ['team_id', 'project_id', 'started_at', 'triggered_by']) {
+            expect(req.has(col)).toBe(true);
+        }
+        // triggered_by enum must contain 'manual' — D-09 is explicit.
+        const triggeredBy = schema.definitions.PersonaDiscoveryRun.properties?.triggered_by;
+        expect(triggeredBy?.enum).toContain('manual');
+    });
+    it('PersonaCandidate tier_suggested enum matches PersonaTier', () => {
+        const schema = readArtifact();
+        const tierProp = schema.definitions.PersonaCandidate.properties?.tier_suggested;
+        expect(tierProp?.enum).toEqual(['primary', 'secondary', 'tertiary']);
+    });
+    it('FrameworkPersonasFile envelope pins the D-03 / D-10 / D-09 surface', () => {
+        const schema = readArtifact();
+        const env = schema.definitions.FrameworkPersonasFile;
+        expect(env.required).toEqual(['schema_version', 'team_id', 'project_id', 'personas']);
+        // canonical_source enum required for D-10 guard to be inspectable.
+        expect(env.properties?.canonical_source?.enum).toEqual(['local', 'cloud']);
+    });
+    it('a framework-shaped envelope passes shape validation (dogfood of D-04)', () => {
+        const schema = readArtifact();
+        const envelopeDef = schema.definitions.FrameworkPersonasFile;
+        const sample = {
+            schema_version: 1,
+            team_id: 'framework-local',
+            project_id: '4081bdd9-b065-4a35-9f97-4879a16f29ba',
+            canonical_source: 'local',
+            updated_at: 1_730_000_000_000,
+            personas: [],
+        };
+        // Manual shape check — avoids pulling in an ajv dep just for this test.
+        // Asserts every required key exists + enum values are respected.
+        for (const k of envelopeDef.required ?? []) {
+            expect(Object.hasOwn(sample, k)).toBe(true);
+        }
+        const canonicalEnum = envelopeDef.properties?.canonical_source?.enum ?? [];
+        expect(canonicalEnum.includes(sample.canonical_source)).toBe(true);
+    });
+    it('extractor is deterministic — fresh run matches the checked-in artifact', () => {
+        // TST-003 fix: extract to a TEMP path, diff TEMP against the checked-in
+        // artifact. The old test read SCHEMA_ARTIFACT before and after the run,
+        // which is a tautology — the extractor writes to that same path, so
+        // before === after is guaranteed as long as the extractor doesn't crash.
+        //
+        // The correct invariant: a fresh extraction must produce byte-identical
+        // output to the checked-in artifact. If the artifact is stale (e.g.,
+        // schema.ts was updated but the artifact was not re-committed), this
+        // test will catch the drift.
+        const tmpDir = mkdtempSync(join(tmpdir(), 'apt-schema-roundtrip-'));
+        const tmpArtifact = join(tmpDir, 'personas-schema.json');
+        try {
+            // Copy the extractor into a tmp script that writes to tmpArtifact
+            // instead of the real OUTPUT_PATH. We patch the constant in-memory
+            // by running a small wrapper that imports the extractor's helpers
+            // and redirects the output path.
+            //
+            // Simpler approach that avoids patching: run the extractor via an
+            // env var that the script checks. Since extract-personas-schema.mjs
+            // has no env-var hook, we use a two-step approach:
+            //   1. Copy the checked-in artifact to tmpArtifact as the reference.
+            //   2. Run the extractor (it writes to SCHEMA_ARTIFACT in-place).
+            //   3. Read the fresh SCHEMA_ARTIFACT.
+            //   4. Restore SCHEMA_ARTIFACT from the reference copy.
+            //   5. Assert fresh === reference.
+            const reference = readFileSync(SCHEMA_ARTIFACT, 'utf-8');
+            // The extractor may skip via the PRF-005 hash guard. Remove the
+            // hash sidecar temporarily so extraction is forced.
+            const hashCachePath = resolve(FRAMEWORK_ROOT, '.build-cache', 'personas-schema.hash');
+            let savedHash = null;
+            if (existsSync(hashCachePath)) {
+                savedHash = readFileSync(hashCachePath, 'utf-8');
+                rmSync(hashCachePath);
+            }
+            let freshOutput;
+            try {
+                const res = spawnSync(process.execPath, [EXTRACTOR], {
+                    encoding: 'utf-8',
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+                expect(res.status).toBe(0);
+                freshOutput = readFileSync(SCHEMA_ARTIFACT, 'utf-8');
+            }
+            finally {
+                // Restore original artifact — this test must be non-destructive.
+                writeFileSync(SCHEMA_ARTIFACT, reference, 'utf-8');
+                // Restore hash sidecar if it existed.
+                if (savedHash !== null) {
+                    mkdirSync(resolve(FRAMEWORK_ROOT, '.build-cache'), { recursive: true });
+                    writeFileSync(hashCachePath, savedHash, 'utf-8');
+                }
+            }
+            // If freshOutput !== reference, the checked-in artifact is stale.
+            // Update it by re-running `pnpm --filter @aperant/framework run build`.
+            expect(freshOutput).toBe(reference);
+        }
+        finally {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=personas-schema-roundtrip.test.js.map

package/dist/__tests__/personas-schema-roundtrip.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas-schema-roundtrip.test.js","sourceRoot":"","sources":["../../src/__tests__/personas-schema-roundtrip.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/personas-sidecar.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * personas-sidecar.test.ts — C48 D-03 / D-09 / D-10 contract.
+ *
+ * Unit-level coverage for the low-level sidecar module (reader/writer for
+ * `.aperant/personas.json` + `.aperant/personas-runs.json`). The CLI smoke
+ * test (personas-cli.test.ts) exercises the dispatcher path; this file
+ * exercises the core functions in isolation where a failure fingerprint is
+ * easier to read.
+ *
+ * Pinned invariants:
+ *   - D-03 sentinel: writes use team_id='framework-local'; project_id pulled
+ *     from .aperant/project.json when present, else 'local:<basename>' fallback.
+ *   - D-10 guard: writeFresh refuses when existing canonical_source='cloud'
+ *     unless force:true is passed.
+ *   - D-09: recordRun appends an entry with triggered_by='manual', keyed on
+ *     a generated id, preserved across multiple calls.
+ */
+export {};
+//# sourceMappingURL=personas-sidecar.test.d.ts.map

package/dist/__tests__/personas-sidecar.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas-sidecar.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/personas-sidecar.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}