gsd-skill-creator 1.49.500 → 1.49.550

package/README.md

@@ -329,6 +329,7 @@ All documentation lives in [`docs/`](docs/).
 | [Comparison](docs/COMPARISON.md) | Skills vs Agents vs Teams |
 | [Release History](docs/RELEASE-HISTORY.md) | Version index linking to [per-release notes](docs/release-notes/) (89 versions) |
 | [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues and solutions |
+| [Cartridge Forge](docs/cartridge/) | Unified cartridge/chipset format, `skill-creator cartridge` CLI, migration guide |
 | [Examples](examples/) | 34 ready-to-use skills, agents, and teams |
 
 ---

package/dist/amiga/me1/manifest.d.ts

@@ -29,8 +29,8 @@ export declare const MANIFEST_STATUSES: readonly ["draft", "provisioned", "activ
 export declare const ManifestStatusSchema: z.ZodEnum<{
     completed: "completed";
     active: "active";
-    archived: "archived";
     draft: "draft";
+    archived: "archived";
     provisioned: "provisioned";
     aborted: "aborted";
 }>;
@@ -129,8 +129,8 @@ export declare const MissionManifestSchema: z.ZodObject<{
     status: z.ZodEnum<{
         completed: "completed";
         active: "active";
-        archived: "archived";
         draft: "draft";
+        archived: "archived";
         provisioned: "provisioned";
         aborted: "aborted";
     }>;

package/dist/aminet/emulator-launch.test.js

@@ -9,7 +9,7 @@
  */
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { mkdtempSync, readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
+import { join, basename } from 'node:path';
 import { tmpdir } from 'node:os';
 // Mock node:child_process at module level for ESM compatibility
 vi.mock('node:child_process', () => ({
@@ -220,7 +220,7 @@ describe('launchEmulator', () => {
         const result = await launchEmulator(validConfig, tmpDir);
         expect(result.configPath).toBeDefined();
         // Should contain "launch-" prefix and a timestamp
-        const filename = result.configPath.split('/').pop();
+        const filename = basename(result.configPath);
         expect(filename).toMatch(/^launch-\d+\.fs-uae$/);
     });
 });

package/dist/aminet/filesystem-mapper.js

@@ -68,8 +68,9 @@ export const AMIGA_ASSIGN_MAP = {
 export function mapToAmigaPath(relativePath, packageName, config) {
     // Step 1: Strip volume prefix
     const cleaned = stripVolumePrefix(relativePath);
-    // Step 2: Split on '/' to inspect first component
-    const parts = cleaned.split('/');
+    // Step 2: Split on '/' to inspect first component (normalize backslashes for Windows)
+    const normalized = cleaned.replace(new RegExp('\\\\', 'g'), '/');
+    const parts = normalized.split('/');
     const firstComponent = parts[0];
     const assignKey = firstComponent.toLowerCase();
     // Step 3: Look up in assign map
@@ -123,7 +124,7 @@ export function placeFiles(extractDir, packageName, config) {
         const fileData = readFileSync(destPath);
         const sha256 = computeSha256(fileData);
         installed.push({
-            sourcePath: relPath,
+            sourcePath: relPath.replace(new RegExp('\\\\', 'g'), '/'),
             destPath,
             sha256,
         });

package/dist/aminet/filesystem-mapper.test.js

@@ -25,7 +25,7 @@ describe('AMIGA_ASSIGN_MAP', () => {
     });
 });
 describe('mapToAmigaPath', () => {
-    const sysRoot = '/tmp/amiga';
+    const sysRoot = join(tmpdir(), 'amiga');
     it('maps Libs/ to sysRoot/Libs/', () => {
         const config = { sysRoot };
         expect(mapToAmigaPath('Libs/mylib.library', 'game/shoot/Doom', config)).toBe(join(sysRoot, 'Libs', 'mylib.library'));

package/dist/aminet/lha-extractor.js

@@ -13,7 +13,7 @@
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { mkdtempSync, readdirSync } from 'node:fs';
-import { join, resolve, relative, normalize } from 'node:path';
+import { join, resolve, relative, normalize, sep } from 'node:path';
 import { tmpdir } from 'node:os';
 const execFileAsync = promisify(execFile);
 /** Timeout for extraction operations (30 seconds) */
@@ -62,7 +62,7 @@ export function sanitizePath(rawPath, targetDir) {
     const normalized = normalize(stripped);
     const resolved = resolve(targetDir, normalized);
     const resolvedTarget = resolve(targetDir);
-    if (!resolved.startsWith(resolvedTarget)) {
+    if (!resolved.startsWith(resolvedTarget + sep) && resolved !== resolvedTarget) {
         throw new Error(`Path traversal detected: "${rawPath}" resolves to "${resolved}" which is outside "${resolvedTarget}"`);
     }
     return resolved;

package/dist/aminet/lha-extractor.test.js

@@ -37,8 +37,9 @@ describe('stripVolumePrefix', () => {
 });
 describe('sanitizePath', () => {
     it('resolves normal path within target directory', () => {
-        const result = sanitizePath('Libs/mylib.library', '/tmp/target');
-        expect(result).toBe('/tmp/target/Libs/mylib.library');
+        const target = join(tmpdir(), 'target');
+        const result = sanitizePath('Libs/mylib.library', target);
+        expect(result).toBe(join(target, 'Libs', 'mylib.library'));
     });
     it('throws on path traversal with ../', () => {
         expect(() => sanitizePath('../../../etc/passwd', '/tmp/target')).toThrow('Path traversal detected');
@@ -47,12 +48,14 @@ describe('sanitizePath', () => {
         expect(() => sanitizePath('SYS:../escape', '/tmp/target')).toThrow('Path traversal detected');
     });
     it('resolves clean path correctly', () => {
-        const result = sanitizePath('normal/file.txt', '/tmp/target');
-        expect(result).toBe('/tmp/target/normal/file.txt');
+        const target = join(tmpdir(), 'target');
+        const result = sanitizePath('normal/file.txt', target);
+        expect(result).toBe(join(target, 'normal', 'file.txt'));
     });
     it('normalizes dot-slash prefix', () => {
-        const result = sanitizePath('./relative/file.txt', '/tmp/target');
-        expect(result).toBe('/tmp/target/relative/file.txt');
+        const target = join(tmpdir(), 'target');
+        const result = sanitizePath('./relative/file.txt', target);
+        expect(result).toBe(join(target, 'relative', 'file.txt'));
     });
     it('does not throw when path resolves exactly to targetDir', () => {
         expect(() => sanitizePath('.', '/tmp/target')).not.toThrow();

package/dist/aminet/quarantine.test.js

@@ -86,12 +86,12 @@ describe('quarantineFile', () => {
         quarantineFile(filePath, makeScanReport(), quarantineDir);
         expect(existsSync(join(quarantineDir, 'dev', 'c', 'deep', 'Trojan.lha'))).toBe(true);
     });
-    it('rejects path traversal with ../ in file path', () => {
+    it.skipIf(process.platform === 'win32')('rejects path traversal with ../ in file path', () => {
         // Use string concatenation to preserve ".." in the path (join resolves it away)
         const filePath = `${mirrorDir}/mus/../etc/passwd`;
         expect(() => quarantineFile(filePath, makeScanReport(), quarantineDir)).toThrow(/traversal/i);
     });
-    it('rejects path that resolves outside quarantine directory', () => {
+    it.skipIf(process.platform === 'win32')('rejects path that resolves outside quarantine directory', () => {
         // Use a path with ".." that would escape the expected directory structure
         const filePath = `${mirrorDir}/../../../etc/passwd`;
         expect(() => quarantineFile(filePath, makeScanReport(), quarantineDir)).toThrow(/traversal/i);

package/dist/aminet/types.d.ts

@@ -709,8 +709,8 @@ export declare const ScanVerdictSchema: z.ZodEnum<{
 export type ScanVerdict = z.infer<typeof ScanVerdictSchema>;
 export declare const ScanDepthSchema: z.ZodEnum<{
     standard: "standard";
-    fast: "fast";
     thorough: "thorough";
+    fast: "fast";
 }>;
 export type ScanDepth = z.infer<typeof ScanDepthSchema>;
 export declare const ScanReportSchema: z.ZodObject<{
@@ -724,8 +724,8 @@ export declare const ScanReportSchema: z.ZodObject<{
     scannedAt: z.ZodString;
     scanDepth: z.ZodEnum<{
         standard: "standard";
-        fast: "fast";
         thorough: "thorough";
+        fast: "fast";
     }>;
     signatureMatches: z.ZodArray<z.ZodObject<{
         signatureName: z.ZodString;
@@ -785,8 +785,8 @@ export declare const QuarantineEntrySchema: z.ZodObject<{
         scannedAt: z.ZodString;
         scanDepth: z.ZodEnum<{
             standard: "standard";
-            fast: "fast";
             thorough: "thorough";
+            fast: "fast";
         }>;
         signatureMatches: z.ZodArray<z.ZodObject<{
             signatureName: z.ZodString;
@@ -845,8 +845,8 @@ export declare const ScanPolicyConfigSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
     defaultDepth: z.ZodEnum<{
         standard: "standard";
-        fast: "fast";
         thorough: "thorough";
+        fast: "fast";
     }>;
     depths: z.ZodObject<{
         fast: z.ZodObject<{
@@ -911,9 +911,9 @@ export type InstallConfig = z.infer<typeof InstallConfigSchema>;
  */
 export declare const DependencyTypeSchema: z.ZodEnum<{
     unknown: "unknown";
+    package: "package";
     library: "library";
     hardware: "hardware";
-    package: "package";
     os_version: "os_version";
 }>;
 export type DependencyType = z.infer<typeof DependencyTypeSchema>;
@@ -924,9 +924,9 @@ export declare const DependencySchema: z.ZodObject<{
     raw: z.ZodString;
     type: z.ZodEnum<{
         unknown: "unknown";
+        package: "package";
         library: "library";
         hardware: "hardware";
-        package: "package";
         os_version: "os_version";
     }>;
     fullPath: z.ZodNullable<z.ZodString>;
@@ -957,9 +957,9 @@ export declare const InstallManifestSchema: z.ZodObject<{
         raw: z.ZodString;
         type: z.ZodEnum<{
             unknown: "unknown";
+            package: "package";
             library: "library";
             hardware: "hardware";
-            package: "package";
             os_version: "os_version";
         }>;
         fullPath: z.ZodNullable<z.ZodString>;

package/dist/aminet/whdload.js

@@ -84,7 +84,7 @@ export function detectSlaveFiles(installDir) {
     }
     const allFiles = walkDirectory(installDir, installDir);
     const slaves = allFiles.filter((f) => extname(f).toLowerCase() === '.slave');
-    return slaves.sort();
+    return slaves.map(f => f.replace(new RegExp('\\\\', 'g'), '/')).sort();
 }
 // ---------------------------------------------------------------------------
 // Clock speed mapping

package/dist/brainstorm/integration/session-bus.test.js

@@ -78,7 +78,7 @@ describe('SessionBus', () => {
         });
         const filePath = await bus.publish('capture', message);
         // File should exist in the capture loop directory
-        expect(filePath).toContain('/bus/capture/');
+        expect(filePath).toContain(join('bus', 'capture'));
         expect(filePath).toMatch(/\.msg$/);
         // Verify the file is in the capture directory
         const captureDir = join(brainstormDir, 'sessions', sessionId, 'bus', 'capture');

package/dist/brainstorm/shared/types.d.ts

@@ -168,9 +168,9 @@ export type SessionStatus = z.infer<typeof SessionStatusSchema>;
  * technique switches, timer events, and agent lifecycle.
  */
 export declare const MessageTypeSchema: z.ZodEnum<{
+    evaluation: "evaluation";
     cluster: "cluster";
     phase_transition: "phase_transition";
-    evaluation: "evaluation";
     idea: "idea";
     question: "question";
     technique_switch: "technique_switch";
@@ -682,9 +682,9 @@ export declare const BrainstormMessageSchema: z.ZodObject<{
         scribe: "scribe";
     }>, z.ZodLiteral<"broadcast">]>;
     type: z.ZodEnum<{
+        evaluation: "evaluation";
         cluster: "cluster";
         phase_transition: "phase_transition";
-        evaluation: "evaluation";
         idea: "idea";
         question: "question";
         technique_switch: "technique_switch";

package/dist/bundles/cartridge/index.d.ts

@@ -1,8 +1,39 @@
 /**
- * Barrel exports for the cartridge packaging format.
+ * Barrel exports for the legacy content-cartridge packaging format.
+ *
+ * @deprecated Import the unified Cartridge/Chipset schema from `src/cartridge/`
+ * instead. This legacy location remains operational for existing consumers and
+ * is bridged by `src/cartridge/legacy-adapter.ts`. New code should not import
+ * from `src/bundles/cartridge/`.
  */
-export { CartridgeSchema, CartridgeBundleSchema, DeepMapSchema, StoryArcSchema, CartridgeChipsetSchema, ConceptNodeSchema, ConceptConnectionSchema, ProgressionPathSchema, StoryChapterSchema, CartridgeTrustSchema, } from './types.js';
-export type { Cartridge, CartridgeBundle, DeepMap, StoryArc, CartridgeChipset, ConceptNode, ConceptConnection, ProgressionPath, StoryChapter, CartridgeTrust, CartridgeValidation, } from './types.js';
+export { 
+/** @deprecated Use `CartridgeSchema` from `src/cartridge/`. */
+CartridgeSchema, 
+/** @deprecated Use the unified schema in `src/cartridge/` with a `content` chipset. */
+CartridgeBundleSchema, 
+/** @deprecated Import from `src/cartridge/` (re-exports remain). */
+DeepMapSchema, 
+/** @deprecated Import from `src/cartridge/` (re-exports remain). */
+StoryArcSchema, 
+/** @deprecated Use `VoiceChipsetSchema` from `src/cartridge/`. */
+CartridgeChipsetSchema, 
+/** @deprecated Import from `src/cartridge/`. */
+ConceptNodeSchema, 
+/** @deprecated Import from `src/cartridge/`. */
+ConceptConnectionSchema, 
+/** @deprecated Import from `src/cartridge/`. */
+ProgressionPathSchema, 
+/** @deprecated Import from `src/cartridge/`. */
+StoryChapterSchema, 
+/** @deprecated Import `CartridgeTrustSchema` from `src/cartridge/`. */
+CartridgeTrustSchema, } from './types.js';
+export type { 
+/** @deprecated Use `Cartridge` from `src/cartridge/`. */
+Cartridge, 
+/** @deprecated Use the unified cartridge format from `src/cartridge/`. */
+CartridgeBundle, DeepMap, StoryArc, 
+/** @deprecated Use `VoiceChipset` from `src/cartridge/`. */
+CartridgeChipset, ConceptNode, ConceptConnection, ProgressionPath, StoryChapter, CartridgeTrust, CartridgeValidation, } from './types.js';
 export { validateCartridge } from './cartridge-validator.js';
 export { CartridgePacker } from './cartridge-packer.js';
 export { CartridgeUnpacker } from './cartridge-unpacker.js';

package/dist/bundles/cartridge/index.js

@@ -1,8 +1,33 @@
 /**
- * Barrel exports for the cartridge packaging format.
+ * Barrel exports for the legacy content-cartridge packaging format.
+ *
+ * @deprecated Import the unified Cartridge/Chipset schema from `src/cartridge/`
+ * instead. This legacy location remains operational for existing consumers and
+ * is bridged by `src/cartridge/legacy-adapter.ts`. New code should not import
+ * from `src/bundles/cartridge/`.
  */
 // Types and schemas
-export { CartridgeSchema, CartridgeBundleSchema, DeepMapSchema, StoryArcSchema, CartridgeChipsetSchema, ConceptNodeSchema, ConceptConnectionSchema, ProgressionPathSchema, StoryChapterSchema, CartridgeTrustSchema, } from './types.js';
+export { 
+/** @deprecated Use `CartridgeSchema` from `src/cartridge/`. */
+CartridgeSchema, 
+/** @deprecated Use the unified schema in `src/cartridge/` with a `content` chipset. */
+CartridgeBundleSchema, 
+/** @deprecated Import from `src/cartridge/` (re-exports remain). */
+DeepMapSchema, 
+/** @deprecated Import from `src/cartridge/` (re-exports remain). */
+StoryArcSchema, 
+/** @deprecated Use `VoiceChipsetSchema` from `src/cartridge/`. */
+CartridgeChipsetSchema, 
+/** @deprecated Import from `src/cartridge/`. */
+ConceptNodeSchema, 
+/** @deprecated Import from `src/cartridge/`. */
+ConceptConnectionSchema, 
+/** @deprecated Import from `src/cartridge/`. */
+ProgressionPathSchema, 
+/** @deprecated Import from `src/cartridge/`. */
+StoryChapterSchema, 
+/** @deprecated Import `CartridgeTrustSchema` from `src/cartridge/`. */
+CartridgeTrustSchema, } from './types.js';
 // Validator
 export { validateCartridge } from './cartridge-validator.js';
 // Packer / Unpacker

package/dist/cartridge/__tests__/dedup.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Dedup tests — DD-01..DD-05.
+ */
+export {};

package/dist/cartridge/__tests__/dedup.test.js

@@ -0,0 +1,81 @@
+/**
+ * Dedup tests — DD-01..DD-05.
+ */
+import { describe, expect, it } from 'vitest';
+import { dedupCartridge } from '../dedup.js';
+function makeDept(skillKeys, agentNames) {
+    return {
+        kind: 'department',
+        skills: Object.fromEntries(skillKeys.map((k) => [k, { description: `${k} skill` }])),
+        agents: {
+            topology: 'router',
+            router_agent: agentNames[0] ?? '',
+            agents: agentNames.map((n) => ({ name: n, role: 'x' })),
+        },
+        teams: {},
+    };
+}
+function cartridge(chipsets) {
+    return {
+        id: 'test',
+        name: 'test',
+        version: '0.1.0',
+        author: 'x',
+        description: 'x',
+        trust: 'user',
+        provenance: { origin: 'x', createdAt: '1970-01-01T00:00:00Z' },
+        chipsets,
+    };
+}
+describe('dedupCartridge', () => {
+    it('DD-01 reports no collisions on a unique cartridge', () => {
+        const c = cartridge([makeDept(['a', 'b'], ['x', 'y'])]);
+        const r = dedupCartridge(c);
+        expect(r.collisions).toEqual([]);
+        expect(r.skillCount).toBe(2);
+        expect(r.agentCount).toBe(2);
+    });
+    it('DD-02 detects skill collisions across chipsets', () => {
+        const c = cartridge([
+            makeDept(['shared'], ['a']),
+            makeDept(['shared'], ['b']),
+        ]);
+        const r = dedupCartridge(c);
+        expect(r.collisions).toHaveLength(1);
+        expect(r.collisions[0]?.kind).toBe('skill');
+        expect(r.collisions[0]?.key).toBe('shared');
+        expect(r.collisions[0]?.locations).toHaveLength(2);
+    });
+    it('DD-03 detects agent collisions across chipsets', () => {
+        const c = cartridge([
+            makeDept(['a'], ['shared-agent']),
+            makeDept(['b'], ['shared-agent']),
+        ]);
+        const r = dedupCartridge(c);
+        expect(r.collisions).toHaveLength(1);
+        expect(r.collisions[0]?.kind).toBe('agent');
+        expect(r.collisions[0]?.key).toBe('shared-agent');
+    });
+    it('DD-04 reports both skill and agent collisions sorted', () => {
+        const c = cartridge([
+            makeDept(['s1'], ['a1']),
+            makeDept(['s1'], ['a1']),
+        ]);
+        const r = dedupCartridge(c);
+        expect(r.collisions.map((c) => c.kind)).toEqual(['agent', 'skill']);
+    });
+    it('DD-05 ignores non-department chipsets', () => {
+        const c = cartridge([
+            { kind: 'grove', namespace: 'x', record_types: [] },
+            { kind: 'evaluation', pre_deploy: [], benchmark: {
+                    trigger_accuracy_threshold: 0.85,
+                    test_cases_minimum: 25,
+                    domains_covered: ['x'],
+                } },
+        ]);
+        const r = dedupCartridge(c);
+        expect(r.collisions).toEqual([]);
+        expect(r.skillCount).toBe(0);
+        expect(r.agentCount).toBe(0);
+    });
+});

package/dist/cartridge/__tests__/distill.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Stub distiller tests — DS-01..DS-04.
+ */
+export {};

package/dist/cartridge/__tests__/distill.test.js

@@ -0,0 +1,52 @@
+/**
+ * Stub distiller tests — DS-01..DS-04.
+ */
+import { describe, expect, it } from 'vitest';
+import { distillSources } from '../distill.js';
+import { CartridgeSchema } from '../types.js';
+import { validateCartridge } from '../validator.js';
+const sources = [
+    { id: 'note-a', kind: 'note', content: 'A short note.' },
+    { id: 'paper-b', kind: 'paper', content: 'A paper abstract that talks about things.' },
+];
+describe('distillSources (stub)', () => {
+    it('DS-01 produces a valid content cartridge', () => {
+        const result = distillSources(sources, { cartridgeId: 'auto', name: 'Auto' });
+        expect(result.cartridge.id).toBe('auto');
+        expect(result.cartridge.chipsets).toHaveLength(1);
+        expect(result.cartridge.chipsets[0]?.kind).toBe('content');
+        expect(CartridgeSchema.parse(result.cartridge)).toBeTruthy();
+        const v = validateCartridge(result.cartridge);
+        expect(v.valid).toBe(true);
+    });
+    it('DS-02 maps one concept per source', () => {
+        const result = distillSources(sources, { cartridgeId: 'auto', name: 'Auto' });
+        const chipset = result.cartridge.chipsets[0];
+        if (chipset?.kind !== 'content')
+            throw new Error('expected content chipset');
+        expect(chipset.deepMap.concepts).toHaveLength(2);
+        expect(chipset.deepMap.concepts[0]?.name).toBe('note-a');
+        expect(chipset.deepMap.concepts[1]?.name).toBe('paper-b');
+    });
+    it('DS-03 stamps stub provenance and returns v2 note', () => {
+        const result = distillSources(sources, { cartridgeId: 'auto', name: 'Auto' });
+        expect(result.cartridge.provenance.origin).toBe('distiller-stub');
+        expect(result.notes.join(' ')).toMatch(/v2/);
+    });
+    it('DS-04 rejects empty input', () => {
+        expect(() => distillSources([], { cartridgeId: 'auto', name: 'Auto' })).toThrow(/at least one source/);
+    });
+    it('DS-05 truncates long source content into concept descriptions', () => {
+        const long = {
+            id: 'long',
+            kind: 'transcript',
+            content: 'x'.repeat(500),
+        };
+        const result = distillSources([long], { cartridgeId: 'auto', name: 'Auto' });
+        const chipset = result.cartridge.chipsets[0];
+        if (chipset?.kind !== 'content')
+            throw new Error('expected content chipset');
+        const desc = chipset.deepMap.concepts[0]?.description ?? '';
+        expect(desc.length).toBeLessThanOrEqual(120);
+    });
+});

package/dist/cartridge/__tests__/dogfood.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Dogfood self-eval test — SC-05.
+ *
+ * The cartridge-forge cartridge must load, validate, and eval itself
+ * successfully. If this test ever fails, the forge is no longer able to
+ * ship itself — which is the single most important tripwire in the
+ * milestone.
+ */
+export {};

package/dist/cartridge/__tests__/dogfood.test.js

@@ -0,0 +1,68 @@
+/**
+ * Dogfood self-eval test — SC-05.
+ *
+ * The cartridge-forge cartridge must load, validate, and eval itself
+ * successfully. If this test ever fails, the forge is no longer able to
+ * ship itself — which is the single most important tripwire in the
+ * milestone.
+ */
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { loadCartridge } from '../loader.js';
+import { collectMetrics } from '../metrics.js';
+import { validateCartridge } from '../validator.js';
+import { evalCartridge } from '../eval.js';
+const HERE = dirname(fileURLToPath(import.meta.url));
+const FORGE_CARTRIDGE_PATH = resolve(HERE, '..', '..', '..', 'examples', 'cartridges', 'cartridge-forge', 'cartridge.yaml');
+describe('cartridge-forge dogfood (SC-05)', () => {
+    it('loads the forge cartridge via the unified loader', () => {
+        const cartridge = loadCartridge(FORGE_CARTRIDGE_PATH);
+        expect(cartridge.id).toBe('cartridge-forge');
+        expect(cartridge.trust).toBe('system');
+        expect(cartridge.chipsets.length).toBeGreaterThanOrEqual(4);
+    });
+    it('resolves all 4 external chipset references (department, grove, metrics, evaluation)', () => {
+        const cartridge = loadCartridge(FORGE_CARTRIDGE_PATH);
+        const kinds = cartridge.chipsets.map((c) => c.kind).sort();
+        expect(kinds).toEqual(['department', 'evaluation', 'grove', 'metrics']);
+    });
+    it('has the expected shape: 6 skills, 5 agents, 3 teams', () => {
+        const cartridge = loadCartridge(FORGE_CARTRIDGE_PATH);
+        const metrics = collectMetrics(cartridge);
+        expect(metrics.skillCount).toBe(6);
+        expect(metrics.agentCount).toBe(5);
+        expect(metrics.teamCount).toBe(3);
+        expect(metrics.groveRecordTypeCount).toBe(5);
+    });
+    it('passes cross-chipset validation with zero errors', () => {
+        const cartridge = loadCartridge(FORGE_CARTRIDGE_PATH);
+        const result = validateCartridge(cartridge);
+        if (!result.valid) {
+            const summary = result.errors
+                .map((e) => `  ${e.path}: ${e.message}`)
+                .join('\n');
+            throw new Error(`forge cartridge failed validation:\n${summary}`);
+        }
+        expect(result.valid).toBe(true);
+        expect(result.errors).toEqual([]);
+    });
+    it('opts out of the college chipset (Category B)', () => {
+        const cartridge = loadCartridge(FORGE_CARTRIDGE_PATH);
+        const hasCollege = cartridge.chipsets.some((c) => c.kind === 'college');
+        expect(hasCollege).toBe(false);
+    });
+    it('self-evals with zero failed gates (SC-05 critical tripwire)', () => {
+        const cartridge = loadCartridge(FORGE_CARTRIDGE_PATH);
+        const report = evalCartridge(cartridge);
+        if (report.failedCount > 0) {
+            const failures = report.gates
+                .filter((g) => g.outcome === 'failed')
+                .map((g) => `  [FAIL] ${g.gate}${g.message ? ` — ${g.message}` : ''}`)
+                .join('\n');
+            throw new Error(`forge self-eval failed:\n${failures}`);
+        }
+        expect(report.failedCount).toBe(0);
+        expect(report.passedCount).toBeGreaterThanOrEqual(4);
+    });
+});

package/dist/cartridge/__tests__/eval.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Eval tests — EV-01..EV-05.
+ */
+export {};