fix(fleet): close persona resolver authority edges

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

packages/mosaic/src/commands/fleet-personas.spec.ts

@@ -71,7 +71,7 @@ describe('FCM class canonicalization and authority', () => {
     });
   });
 
-  it.each(['worker', 'analyst', 'canary', 'tess', 'ultron'])(
+  it.each(['worker', 'analyst', 'canary', 'tess', 'ultron', 'constructor'])(
     'does not infer an alias for %s',
     (requested: string) => {
       expect(canonicalizeRoleClass(requested)).toEqual({
@@ -81,6 +81,28 @@ describe('FCM class canonicalization and authority', () => {
     },
   );
 
+  it('resolves inherited-property class names without granting protected authority', async () => {
+    await mkdir(overrideDir, { recursive: true });
+    await writeFile(
+      join(overrideDir, 'constructor.md'),
+      overridePersona('constructor', 'custom'),
+      'utf8',
+    );
+
+    const resolved = await resolvePersona('constructor', { rolesDir, overrideDir });
+    expect(resolved).toMatchObject({
+      requestedClass: 'constructor',
+      canonicalClass: 'constructor',
+      klass: 'constructor',
+      layer: 'override',
+    });
+    expect(authorityForCanonicalClass('constructor')).toMatchObject({
+      mayMerge: false,
+      mayIssueValidationCertificate: false,
+      mayOrchestrate: false,
+    });
+  });
+
   it('canonicalizes before override lookup and lets the canonical override win', async () => {
     await mkdir(overrideDir, { recursive: true });
     await writeFile(
@@ -258,6 +280,23 @@ describe('resolvePersona — override wins', () => {
     ).toBe(false);
   });
 
+  it('rejects a canonical filename whose explicit marker names another class', async () => {
+    await mkdir(overrideDir, { recursive: true });
+    await writeFile(join(overrideDir, 'merge-gate.md'), overridePersona('mascot', 'fun'), 'utf8');
+    await writeFile(
+      join(rolesDir, 'merge-gate.md'),
+      baselinePersona('merge-gate', 'governance'),
+      'utf8',
+    );
+
+    expect(await resolvePersona('merge-gate', { rolesDir, overrideDir })).toBeNull();
+    expect(resolvePersonaSync('merge-gate', { rolesDir, overrideDir })).toBeNull();
+    expect((await listPersonaClasses({ rolesDir, overrideDir })).has('merge-gate')).toBe(false);
+    expect(
+      (await personaStatus({ rolesDir, overrideDir })).some(({ klass }) => klass === 'merge-gate'),
+    ).toBe(false);
+  });
+
   it('fails closed if a marker-defined override becomes unreadable after extraction', async () => {
     await mkdir(overrideDir, { recursive: true });
     const overrideFile = join(overrideDir, 'engineering.md');
@@ -294,6 +333,26 @@ describe('resolvePersona — override wins', () => {
     expect(status.get('mascot')?.status).toBe('custom');
   });
 
+  it('fails closed if a markerless cached override gains a conflicting marker', async () => {
+    await mkdir(overrideDir, { recursive: true });
+    const overrideFile = join(overrideDir, 'merge-gate.md');
+    await writeFile(overrideFile, '# markerless merge gate\n', 'utf8');
+    await writeFile(
+      join(rolesDir, 'merge-gate.md'),
+      baselinePersona('merge-gate', 'governance'),
+      'utf8',
+    );
+    const [base, over] = await Promise.all([
+      extractClassesFromDir(rolesDir),
+      extractClassesFromDir(overrideDir),
+    ]);
+    await writeFile(overrideFile, overridePersona('mascot', 'fun'), 'utf8');
+
+    expect(
+      await resolvePersonaFrom('merge-gate', { rolesDir, overrideDir, base, over }),
+    ).toBeNull();
+  });
+
   it('fails closed asynchronously when the override directory cannot be scanned', async () => {
     await writeFile(overrideDir, 'not a directory', 'utf8');
     expect(await resolvePersona('code', { rolesDir, overrideDir })).toBeNull();
@@ -364,6 +423,27 @@ describe('resolvePersona — override wins', () => {
     ).toBeNull();
   });
 
+  it('revalidates a cached scanned override before baseline fallback', async () => {
+    await mkdir(overrideDir, { recursive: true });
+    const [base, over] = await Promise.all([
+      extractClassesFromDir(rolesDir),
+      extractClassesFromDir(overrideDir),
+    ]);
+    expect(over.scanState).toBe('scanned');
+    expect(over.classes.size).toBe(0);
+
+    await writeFile(join(overrideDir, 'engineering.md'), overridePersona('code', 'engineering'));
+
+    const resolved = await resolvePersonaFrom('code', {
+      rolesDir,
+      overrideDir,
+      base,
+      over,
+    });
+    expect(resolved?.layer).toBe('override');
+    expect(resolved?.file).toBe(join(overrideDir, 'engineering.md'));
+  });
+
   it('falls back to baseline asynchronously and synchronously when override directory is missing', async () => {
     const asyncResolution = await resolvePersona('code', { rolesDir, overrideDir });
     const syncResolution = resolvePersonaSync('code', { rolesDir, overrideDir });

packages/mosaic/src/commands/fleet-personas.ts

@@ -71,7 +71,9 @@ export interface CanonicalRoleClass {
 /** Canonicalize only the three explicitly approved compatibility aliases. */
 export function canonicalizeRoleClass(requestedClass: string): CanonicalRoleClass {
   const requested = requestedClass.trim();
-  const canonical = ROLE_CLASS_ALIASES[requested as keyof typeof ROLE_CLASS_ALIASES] ?? requested;
+  const canonical = Object.hasOwn(ROLE_CLASS_ALIASES, requested)
+    ? ROLE_CLASS_ALIASES[requested as keyof typeof ROLE_CLASS_ALIASES]
+    : requested;
   return Object.freeze({ requestedClass: requested, canonicalClass: canonical });
 }
 
@@ -121,7 +123,9 @@ export const ROLE_AUTHORITY_BY_CANONICAL_CLASS: Readonly<Record<string, RoleAuth
 
 /** Return protected authority for an already-canonical class; custom classes get none. */
 export function authorityForCanonicalClass(canonicalClass: string): RoleAuthority {
-  return ROLE_AUTHORITY_BY_CANONICAL_CLASS[canonicalClass] ?? NO_PROTECTED_AUTHORITY;
+  return Object.hasOwn(ROLE_AUTHORITY_BY_CANONICAL_CLASS, canonicalClass)
+    ? ROLE_AUTHORITY_BY_CANONICAL_CLASS[canonicalClass]!
+    : NO_PROTECTED_AUTHORITY;
 }
 
 /** One discovered persona file (a single role contract on disk). */
@@ -286,15 +290,6 @@ function hasBrokenSymlinkInPathSync(path: string): boolean {
   return false;
 }
 
-async function missingScanStillValid(dir: string): Promise<boolean> {
-  try {
-    await readdir(dir);
-    return false;
-  } catch (error) {
-    return (await classifyScanFailure(dir, error)) === 'missing';
-  }
-}
-
 function isMissingPathError(error: unknown): boolean {
   return (
     typeof error === 'object' &&
@@ -314,10 +309,9 @@ function accumulateEntry(acc: DirClasses, dir: string, entry: string, text: stri
   const { classes, byClass } = acc;
   if (entry === 'LIBRARY.md') return;
 
-  // A successfully read role file is addressable by filename, including
-  // marker-less compatibility contracts such as planner.md.
+  // An explicit first marker owns identity. Filename identity is a fallback only
+  // for markerless compatibility contracts such as planner.md.
   const stem = basename(entry, '.md');
-  classes.add(stem);
   const domainMatch = DOMAIN_MARKER.exec(text);
   const domain = domainMatch?.[1];
   const firstMarker = text.matchAll(CLASS_MARKER).next().value as RegExpExecArray | undefined;
@@ -330,8 +324,9 @@ function accumulateEntry(acc: DirClasses, dir: string, entry: string, text: stri
       markerDefined: true,
       ...(domain ? { domain } : {}),
     });
-  } else if (!byClass.has(stem)) {
-    byClass.set(stem, { klass: stem, file: join(dir, entry) });
+  } else {
+    classes.add(stem);
+    if (!byClass.has(stem)) byClass.set(stem, { klass: stem, file: join(dir, entry) });
   }
 }
 
@@ -386,6 +381,10 @@ async function readPersonaFromLayer(
     const byName = join(dir, `${canonicalClass}.md`);
     try {
       const content = await readFile(byName, 'utf8');
+      const currentMarker = content.matchAll(CLASS_MARKER).next().value as
+        | RegExpExecArray
+        | undefined;
+      if (currentMarker && currentMarker[1] !== canonicalClass) return null;
       const dm = DOMAIN_MARKER.exec(content);
       return {
         requestedClass,
@@ -405,7 +404,7 @@ async function readPersonaFromLayer(
     const currentMarker = content.matchAll(CLASS_MARKER).next().value as
       | RegExpExecArray
       | undefined;
-    if (pf.markerDefined && currentMarker?.[1] !== canonicalClass) return null;
+    if (currentMarker && currentMarker[1] !== canonicalClass) return null;
     const dm = DOMAIN_MARKER.exec(content);
     return {
       requestedClass,
@@ -442,6 +441,10 @@ function readPersonaFromLayerSync(
     const byName = join(dir, `${canonicalClass}.md`);
     try {
       const content = readFileSync(byName, 'utf8');
+      const currentMarker = content.matchAll(CLASS_MARKER).next().value as
+        | RegExpExecArray
+        | undefined;
+      if (currentMarker && currentMarker[1] !== canonicalClass) return null;
       const dm = DOMAIN_MARKER.exec(content);
       return {
         requestedClass,
@@ -461,7 +464,7 @@ function readPersonaFromLayerSync(
     const currentMarker = content.matchAll(CLASS_MARKER).next().value as
       | RegExpExecArray
       | undefined;
-    if (pf.markerDefined && currentMarker?.[1] !== canonicalClass) return null;
+    if (currentMarker && currentMarker[1] !== canonicalClass) return null;
     const dm = DOMAIN_MARKER.exec(content);
     return {
       requestedClass,
@@ -512,10 +515,22 @@ export async function resolvePersonaFrom(
 
   const override = await readPersonaFromLayer(requested, klass, overrideDir, over, 'override');
   if (override) return override;
-  // An explicit canonical override that cannot be resolved/read must shadow the
-  // baseline fail-closed; only an absent override may fall back.
+  // An observed explicit override that cannot resolve/read shadows the baseline.
   if (overrideShadowsBaseline(over, klass)) return null;
-  if (over.scanState === 'missing' && !(await missingScanStillValid(overrideDir))) return null;
+
+  // Cached scans are only snapshots. Re-scan immediately before baseline fallback
+  // so a newly created canonical or marker-defined override cannot be skipped.
+  const currentOver = await extractClassesFromDir(overrideDir);
+  const currentOverride = await readPersonaFromLayer(
+    requested,
+    klass,
+    overrideDir,
+    currentOver,
+    'override',
+  );
+  if (currentOverride) return currentOverride;
+  if (overrideShadowsBaseline(currentOver, klass)) return null;
+  if (currentOver.scanState === 'error') return null;
   return readPersonaFromLayer(requested, klass, rolesDir, base, 'baseline');
 }