@aperant/framework 0.6.2

package/dist/__tests__/product-context.test.js

@@ -0,0 +1,117 @@
+/**
+ * product-context.test.ts — unit coverage for design/product-context.mjs (C44).
+ *
+ * Pins the pure-function contract of `loadProductContext`:
+ *   - missing file ≠ error (present:false, source:none)
+ *   - valid file → normalized WizardProductContext shape
+ *   - malformed JSON → errors[] populated
+ *   - schema violation (missing required field) → errors[] populated
+ *   - additive keys pass through (permissive, matches design-frontmatter style)
+ *
+ * No network, no spawnSync — the loader is a pure file read.
+ */
+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 { loadProductContext, productContextPath } from '../cli/design/product-context.mjs';
+function writeFixture(root, contents) {
+    const aperant = join(root, '.aperant');
+    mkdirSync(aperant, { recursive: true });
+    const target = join(aperant, 'product-context.json');
+    const body = typeof contents === 'string' ? contents : JSON.stringify(contents, null, 2);
+    writeFileSync(target, body, 'utf8');
+    return target;
+}
+describe('loadProductContext', () => {
+    let root;
+    beforeEach(() => {
+        root = mkdtempSync(join(tmpdir(), 'apt-c44-'));
+    });
+    afterEach(() => {
+        try {
+            rmSync(root, { recursive: true, force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+    });
+    it('returns present:false with no errors when product-context.json is absent', () => {
+        const res = loadProductContext(root);
+        expect(res.present).toBe(false);
+        expect(res.source).toBe('none');
+        expect(res.productContext).toBeNull();
+        expect(res.errors).toEqual([]);
+        expect(res.warnings).toEqual([]);
+        expect(res.path).toBe(productContextPath(root));
+    });
+    it('parses and normalizes a valid product-context.json to WizardProductContext shape', () => {
+        writeFixture(root, {
+            productName: 'DevLogs',
+            productDescription: 'CLI log analyzer for senior backend engineers.',
+            targetAudience: 'developers',
+            features: [
+                { id: 'regex', name: 'Regex filtering', description: 'Filter lines by pattern.' },
+                { id: 'json', name: 'JSON parsing' },
+            ],
+            _meta: { source: 'wizard-manual', updatedAt: '2026-04-19T10:00:00Z' },
+        });
+        const res = loadProductContext(root);
+        expect(res.errors).toEqual([]);
+        expect(res.present).toBe(true);
+        expect(res.source).toBe('aperant-file');
+        expect(res.productContext).not.toBeNull();
+        const pc = res.productContext;
+        if (!pc)
+            throw new Error('expected productContext to be populated');
+        expect(pc.productName).toBe('DevLogs');
+        expect(pc.targetAudience).toBe('developers');
+        expect(pc.features.length).toBe(2);
+        expect(pc.features[0]?.id).toBe('regex');
+        expect(pc.features[0]?.description).toBe('Filter lines by pattern.');
+        // Feature without description normalizes to empty string (never undefined).
+        expect(pc.features[1]?.description).toBe('');
+        expect(pc._meta?.source).toBe('wizard-manual');
+    });
+    it('returns an error when product-context.json is malformed JSON', () => {
+        writeFixture(root, '{ this is not json ');
+        const res = loadProductContext(root);
+        expect(res.present).toBe(false);
+        expect(res.productContext).toBeNull();
+        expect(res.errors.length).toBeGreaterThan(0);
+        expect(res.errors.join('\n')).toMatch(/invalid JSON/);
+    });
+    it('returns an error when a required field (productName) is missing', () => {
+        writeFixture(root, {
+            // productName intentionally missing
+            productDescription: 'Something.',
+            targetAudience: 'anyone',
+            features: [],
+        });
+        const res = loadProductContext(root);
+        expect(res.present).toBe(false);
+        expect(res.errors.length).toBeGreaterThan(0);
+        expect(res.errors.some((e) => e.includes('productName'))).toBe(true);
+    });
+    it('accepts additive top-level keys (permissive shape, no strict rejection)', () => {
+        writeFixture(root, {
+            productName: 'LearnBuddy',
+            productDescription: 'Interactive reading app for ages 5-8.',
+            targetAudience: 'children and parents',
+            features: [],
+            // extra top-level key the schema does not know about
+            experimentalNotes: 'seeded from inference',
+        });
+        const res = loadProductContext(root);
+        expect(res.errors).toEqual([]);
+        expect(res.present).toBe(true);
+        expect(res.productContext?.productName).toBe('LearnBuddy');
+    });
+    it('rejects a non-object top-level value (e.g., an array) with a structured error', () => {
+        writeFixture(root, [{ productName: 'x' }]);
+        const res = loadProductContext(root);
+        expect(res.present).toBe(false);
+        expect(res.errors.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=product-context.test.js.map

package/dist/__tests__/product-context.test.js.map

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

package/dist/__tests__/profile-cli.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * C19 subtask 8 — apt-tools profile CLI tests.
+ */
+export {};
+//# sourceMappingURL=profile-cli.test.d.ts.map

package/dist/__tests__/profile-cli.test.d.ts.map

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

package/dist/__tests__/profile-cli.test.js

@@ -0,0 +1,134 @@
+/**
+ * C19 subtask 8 — apt-tools profile CLI tests.
+ */
+import { execSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+const APT_TOOLS = resolve(__dirname, '../../bin/apt-tools.mjs');
+function makeProject() {
+    const root = mkdtempSync(join(tmpdir(), 'apt-profile-cli-'));
+    mkdirSync(join(root, '.aperant', 'profiles'), { recursive: true });
+    return root;
+}
+function writeProfile(root, name, yaml) {
+    writeFileSync(join(root, '.aperant', 'profiles', `${name}.yaml`), yaml);
+}
+function run(cwd, ...args) {
+    try {
+        const out = execSync(`node ${APT_TOOLS} ${args.join(' ')}`, {
+            encoding: 'utf-8',
+            cwd,
+            env: { ...process.env, APT_SUPPRESS_GITIGNORE_DRIFT: '1' },
+        });
+        return { code: 0, out };
+    }
+    catch (err) {
+        const e = err;
+        return { code: e.status ?? 1, out: e.stdout ?? '' };
+    }
+}
+describe('apt-tools profile list', () => {
+    let root;
+    afterEach(() => {
+        if (root)
+            rmSync(root, { recursive: true, force: true });
+    });
+    it('emits ok + count: 0 when no profiles exist', () => {
+        root = makeProject();
+        const { code, out } = run(root, 'profile', 'list', '.');
+        expect(code).toBe(0);
+        const env = JSON.parse(out);
+        expect(env.status).toBe('ok');
+        expect(env.command).toBe('profile-list');
+        expect(env.count).toBe(0);
+    });
+    it('lists seeded profiles', () => {
+        root = makeProject();
+        writeProfile(root, 'default', 'name: default\n');
+        writeProfile(root, 'team-platform', 'name: team-platform\nextends: default\n');
+        const { code, out } = run(root, 'profile', 'list', '.');
+        expect(code).toBe(0);
+        const env = JSON.parse(out);
+        expect(env.count).toBe(2);
+        const names = env.profiles.map((p) => p.name).sort();
+        expect(names).toEqual(['default', 'team-platform']);
+    });
+});
+describe('apt-tools profile validate', () => {
+    let root;
+    afterEach(() => {
+        if (root)
+            rmSync(root, { recursive: true, force: true });
+    });
+    it('returns ok for a valid linear chain', () => {
+        root = makeProject();
+        writeProfile(root, 'default', 'name: default\n');
+        writeProfile(root, 'team', 'name: team\nextends: default\n');
+        const { code, out } = run(root, 'profile', 'validate', '.', '--name', 'team');
+        expect(code).toBe(0);
+        const env = JSON.parse(out);
+        expect(env.status).toBe('ok');
+        expect(env.chain).toEqual(['default', 'team']);
+    });
+    it('returns fail for a cycle', () => {
+        root = makeProject();
+        writeProfile(root, 'a', 'name: a\nextends: b\n');
+        writeProfile(root, 'b', 'name: b\nextends: a\n');
+        const { code, out } = run(root, 'profile', 'validate', '.', '--name', 'a');
+        expect(code).toBe(0);
+        const env = JSON.parse(out);
+        expect(env.status).toBe('fail');
+        expect(env.reason).toMatch(/cycle detected/);
+    });
+    it('returns fail for dangling extends', () => {
+        root = makeProject();
+        writeProfile(root, 'team', 'name: team\nextends: ghost\n');
+        const { code, out } = run(root, 'profile', 'validate', '.', '--name', 'team');
+        const env = JSON.parse(out);
+        expect(env.status).toBe('fail');
+        expect(env.reason).toMatch(/unknown parent profile: ghost/);
+    });
+});
+describe('apt-tools profile resolve', () => {
+    let root;
+    afterEach(() => {
+        if (root)
+            rmSync(root, { recursive: true, force: true });
+    });
+    it('returns the merged resolved output', () => {
+        root = makeProject();
+        writeProfile(root, 'default', [
+            'name: default',
+            'obligations:',
+            '  - id: o1',
+            '    title: Parent obligation',
+            '    text: parent',
+            '    severity: must',
+            '',
+        ].join('\n'));
+        writeProfile(root, 'team', [
+            'name: team',
+            'extends: default',
+            'merge_obligations: true',
+            'obligations:',
+            '  - id: o2',
+            '    title: Child obligation',
+            '    text: child',
+            '    severity: should',
+            '',
+        ].join('\n'));
+        const { code, out } = run(root, 'profile', 'resolve', '.', '--name', 'team');
+        expect(code).toBe(0);
+        const env = JSON.parse(out);
+        expect(env.status).toBe('ok');
+        expect(env.command).toBe('profile-resolve');
+        expect(env.chain).toEqual(['default', 'team']);
+        expect(env.resolved.name).toBe('team');
+        expect(env.resolved.obligations).toHaveLength(2);
+        // merge_* sentinels must not leak into the resolved output
+        expect(env.resolved).not.toHaveProperty('merge_obligations');
+    });
+});
+//# sourceMappingURL=profile-cli.test.js.map

package/dist/__tests__/profile-cli.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-cli.test.js","sourceRoot":"","sources":["../../src/__tests__/profile-cli.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAExD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAA;AAE/D,SAAS,WAAW;IACnB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAC5D,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAClE,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY;IAC7D,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,CAAC,CAAA;AACxE,CAAC;AAED,SAAS,GAAG,CAAC,GAAW,EAAE,GAAG,IAAc;IAC1C,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;YAC3D,QAAQ,EAAE,OAAO;YACjB,GAAG;YACH,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,4BAA4B,EAAE,GAAG,EAAuB;SAC/E,CAAC,CAAA;QACF,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAA;IACxB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA2C,CAAA;QACrD,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAA;IACpD,CAAC;AACF,CAAC;AAED,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACvC,IAAI,IAAY,CAAA;IAChB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACrD,IAAI,GAAG,WAAW,EAAE,CAAA;QACpB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;QACvD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QACxC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAChC,IAAI,GAAG,WAAW,EAAE,CAAA;QACpB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAA;QAChD,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,yCAAyC,CAAC,CAAA;QAC9E,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;QACvD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;QACtE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC3C,IAAI,IAAY,CAAA;IAChB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC9C,IAAI,GAAG,WAAW,EAAE,CAAA;QACpB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAA;QAChD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,gCAAgC,CAAC,CAAA;QAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC7E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACnC,IAAI,GAAG,WAAW,EAAE,CAAA;QACpB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAA;QAChD,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,uBAAuB,CAAC,CAAA;QAChD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAA;QAC1E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC5C,IAAI,GAAG,WAAW,EAAE,CAAA;QACpB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,8BAA8B,CAAC,CAAA;QAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IAC1C,IAAI,IAAY,CAAA;IAChB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC7C,IAAI,GAAG,WAAW,EAAE,CAAA;QACpB,YAAY,CACX,IAAI,EACJ,SAAS,EACT;YACC,eAAe;YACf,cAAc;YACd,YAAY;YACZ,8BAA8B;YAC9B,kBAAkB;YAClB,oBAAoB;YACpB,EAAE;SACF,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ,CAAA;QACD,YAAY,CACX,IAAI,EACJ,MAAM,EACN;YACC,YAAY;YACZ,kBAAkB;YAClB,yBAAyB;YACzB,cAAc;YACd,YAAY;YACZ,6BAA6B;YAC7B,iBAAiB;YACjB,sBAAsB;YACtB,EAAE;SACF,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ,CAAA;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC5E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC3C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;QAC9C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACtC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAChD,2DAA2D;QAC3D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/profile-parse.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * C19 subtask 6 — profile parse + schema unit tests.
+ */
+export {};
+//# sourceMappingURL=profile-parse.test.d.ts.map

package/dist/__tests__/profile-parse.test.d.ts.map

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

package/dist/__tests__/profile-parse.test.js

@@ -0,0 +1,151 @@
+/**
+ * C19 subtask 6 — profile parse + schema unit tests.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { listProfiles, loadProfile } from '../cli/profile/parse.mjs';
+function makeProject() {
+    const root = mkdtempSync(join(tmpdir(), 'apt-profile-parse-'));
+    mkdirSync(join(root, '.aperant', 'profiles'), { recursive: true });
+    return root;
+}
+function writeProfile(root, name, yaml) {
+    writeFileSync(join(root, '.aperant', 'profiles', `${name}.yaml`), yaml);
+}
+describe('loadProfile', () => {
+    let root;
+    afterEach(() => {
+        if (root)
+            rmSync(root, { recursive: true, force: true });
+    });
+    it('loads a valid minimal profile (name only)', () => {
+        root = makeProject();
+        writeProfile(root, 'default', 'name: default\n');
+        const res = loadProfile(root, 'default');
+        expect(res.ok).toBe(true);
+        if (res.ok) {
+            expect(res.profile.name).toBe('default');
+        }
+    });
+    it('loads a valid full profile', () => {
+        root = makeProject();
+        writeProfile(root, 'team-platform', [
+            'name: team-platform',
+            'extends: default',
+            'description: Platform team conventions',
+            'merge_obligations: true',
+            'merge_conventions: true',
+            'merge_tooling: true',
+            'obligations:',
+            '  - id: obs-traces',
+            '    title: Emit OpenTelemetry traces',
+            '    text: HTTP handlers wrap into otel.trace.startActiveSpan',
+            '    severity: must',
+            'conventions:',
+            '  imports: extensionless',
+            'tooling:',
+            '  linter: biome',
+            '',
+        ].join('\n'));
+        const res = loadProfile(root, 'team-platform');
+        expect(res.ok).toBe(true);
+        if (res.ok) {
+            expect(res.profile.extends).toBe('default');
+            expect(res.profile.obligations?.[0].id).toBe('obs-traces');
+            expect(res.profile.merge_obligations).toBe(true);
+        }
+    });
+    it('rejects an invalid name (uppercase / spaces)', () => {
+        root = makeProject();
+        writeProfile(root, 'bad-name', 'name: BadName\n');
+        const res = loadProfile(root, 'bad-name');
+        expect(res.ok).toBe(false);
+    });
+    it('rejects an unknown top-level key (.strict())', () => {
+        root = makeProject();
+        writeProfile(root, 'default', 'name: default\nextra_field: nope\n');
+        const res = loadProfile(root, 'default');
+        expect(res.ok).toBe(false);
+    });
+    it('rejects an invalid severity value', () => {
+        root = makeProject();
+        writeProfile(root, 'default', [
+            'name: default',
+            'obligations:',
+            '  - id: x',
+            '    title: t',
+            '    text: body',
+            '    severity: bogus',
+        ].join('\n'));
+        const res = loadProfile(root, 'default');
+        expect(res.ok).toBe(false);
+    });
+    it('rejects filename/name mismatch', () => {
+        root = makeProject();
+        writeProfile(root, 'foo', 'name: bar\n');
+        const res = loadProfile(root, 'foo');
+        expect(res.ok).toBe(false);
+        if (!res.ok) {
+            expect(res.errors[0].message).toMatch(/does not match filename/);
+        }
+    });
+    it('reports a clear error for malformed YAML', () => {
+        root = makeProject();
+        writeProfile(root, 'default', 'name: default\n:::not: valid');
+        const res = loadProfile(root, 'default');
+        expect(res.ok).toBe(false);
+    });
+    it('reports profile-not-found when the file is missing', () => {
+        root = makeProject();
+        const res = loadProfile(root, 'missing');
+        expect(res.ok).toBe(false);
+        if (!res.ok) {
+            expect(res.errors[0].message).toMatch(/profile not found/);
+        }
+    });
+    it('rejects path-traversal style names without touching the filesystem', () => {
+        // Defense-in-depth: a CLI --name flag must not be able to read outside
+        // .aperant/profiles/. The slug regex is enforced before any fs call.
+        root = makeProject();
+        for (const bad of ['../etc/passwd', '..', 'foo/bar', 'A', '']) {
+            const res = loadProfile(root, bad);
+            expect(res.ok).toBe(false);
+            if (!res.ok) {
+                expect(res.errors[0].message).toMatch(/invalid profile name/);
+            }
+        }
+    });
+});
+describe('listProfiles', () => {
+    let root;
+    afterEach(() => {
+        if (root)
+            rmSync(root, { recursive: true, force: true });
+    });
+    it('returns [] when .aperant/profiles/ does not exist', () => {
+        root = mkdtempSync(join(tmpdir(), 'apt-profile-list-empty-'));
+        expect(listProfiles(root)).toEqual([]);
+    });
+    it('returns [] when profiles dir is empty', () => {
+        root = makeProject();
+        expect(listProfiles(root)).toEqual([]);
+    });
+    it('lists mixed valid + invalid profiles', () => {
+        root = makeProject();
+        writeProfile(root, 'default', 'name: default\n');
+        writeProfile(root, 'broken', 'name: BadName\n'); // invalid slug
+        writeProfile(root, 'team-platform', 'name: team-platform\nextends: default\n');
+        // Also drop a non-yaml file — should be ignored.
+        writeFileSync(join(root, '.aperant', 'profiles', 'README.md'), 'ignored');
+        const entries = listProfiles(root);
+        expect(entries).toHaveLength(3);
+        const byName = new Map(entries.map((e) => [e.name, e]));
+        expect(byName.get('default')?.valid).toBe(true);
+        expect(byName.get('team-platform')?.valid).toBe(true);
+        expect(byName.get('team-platform')?.extends).toBe('default');
+        expect(byName.get('broken')?.valid).toBe(false);
+    });
+});
+//# sourceMappingURL=profile-parse.test.js.map

package/dist/__tests__/profile-parse.test.js.map

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

package/dist/__tests__/profile-resolve.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * C19 subtask 7 — profile cascade resolution unit tests.
+ */
+export {};
+//# sourceMappingURL=profile-resolve.test.d.ts.map

package/dist/__tests__/profile-resolve.test.d.ts.map

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

package/dist/__tests__/profile-resolve.test.js

@@ -0,0 +1,181 @@
+/**
+ * C19 subtask 7 — profile cascade resolution unit tests.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { MAX_PROFILE_DEPTH, resolveProfile } from '../cli/profile/resolve.mjs';
+function makeProject() {
+    const root = mkdtempSync(join(tmpdir(), 'apt-profile-resolve-'));
+    mkdirSync(join(root, '.aperant', 'profiles'), { recursive: true });
+    return root;
+}
+function writeProfile(root, name, body) {
+    const lines = [`name: ${name}`];
+    for (const [k, v] of Object.entries(body)) {
+        if (v === undefined)
+            continue;
+        if (typeof v === 'string' || typeof v === 'boolean' || typeof v === 'number') {
+            lines.push(`${k}: ${v}`);
+        }
+        else {
+            lines.push(`${k}: ${JSON.stringify(v)}`);
+        }
+    }
+    writeFileSync(join(root, '.aperant', 'profiles', `${name}.yaml`), `${lines.join('\n')}\n`);
+}
+describe('resolveProfile', () => {
+    let root;
+    afterEach(() => {
+        if (root)
+            rmSync(root, { recursive: true, force: true });
+    });
+    it('no extends → resolved equals source (minus merge_* sentinels)', () => {
+        root = makeProject();
+        writeProfile(root, 'default', {
+            description: 'root',
+            obligations: [{ id: 'o1', title: 'T', text: 'body', severity: 'must' }],
+            merge_obligations: true, // should be stripped
+        });
+        const res = resolveProfile(root, 'default');
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.chain).toEqual(['default']);
+        expect(res.resolved.name).toBe('default');
+        expect(Object.hasOwn(res.resolved, 'merge_obligations')).toBe(false);
+        expect(res.resolved.obligations).toHaveLength(1);
+    });
+    it('merge_obligations: true → concat + dedup by id (child wins)', () => {
+        root = makeProject();
+        writeProfile(root, 'default', {
+            obligations: [
+                { id: 'a', title: 'A-parent', text: 'p', severity: 'must' },
+                { id: 'b', title: 'B', text: 'p', severity: 'must' },
+            ],
+        });
+        writeProfile(root, 'team', {
+            extends: 'default',
+            merge_obligations: true,
+            obligations: [
+                { id: 'a', title: 'A-child', text: 'c', severity: 'should' }, // overrides
+                { id: 'c', title: 'C', text: 'c', severity: 'must' },
+            ],
+        });
+        const res = resolveProfile(root, 'team');
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.chain).toEqual(['default', 'team']);
+        const obs = res.resolved.obligations;
+        const byId = new Map(obs.map((o) => [o.id, o]));
+        expect(byId.size).toBe(3);
+        expect(byId.get('a')?.title).toBe('A-child');
+        expect(byId.get('a')?.severity).toBe('should');
+    });
+    it('merge_obligations unset → child replaces parent entirely', () => {
+        root = makeProject();
+        writeProfile(root, 'default', {
+            obligations: [{ id: 'a', title: 'A', text: 'p', severity: 'must' }],
+        });
+        writeProfile(root, 'team', {
+            extends: 'default',
+            obligations: [{ id: 'z', title: 'Z', text: 'c', severity: 'should' }],
+        });
+        const res = resolveProfile(root, 'team');
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.resolved.obligations).toHaveLength(1);
+        expect(res.resolved.obligations[0].id).toBe('z');
+    });
+    it('cycle a → b → a produces cycle detected', () => {
+        root = makeProject();
+        writeProfile(root, 'a', { extends: 'b' });
+        writeProfile(root, 'b', { extends: 'a' });
+        const res = resolveProfile(root, 'a');
+        expect(res.ok).toBe(false);
+        if (res.ok)
+            return;
+        expect(res.reason).toMatch(/cycle detected/);
+    });
+    it('self-cycle a → a fails', () => {
+        root = makeProject();
+        writeProfile(root, 'a', { extends: 'a' });
+        const res = resolveProfile(root, 'a');
+        expect(res.ok).toBe(false);
+        if (res.ok)
+            return;
+        expect(res.reason).toMatch(/cycle detected/);
+    });
+    it('dangling extends → unknown parent profile', () => {
+        root = makeProject();
+        writeProfile(root, 'team', { extends: 'ghost' });
+        const res = resolveProfile(root, 'team');
+        expect(res.ok).toBe(false);
+        if (res.ok)
+            return;
+        expect(res.reason).toMatch(/unknown parent profile: ghost/);
+    });
+    it('depth > 8 fails with max profile depth exceeded', () => {
+        root = makeProject();
+        // Build a 10-deep chain: p0 extends p1 extends p2 … extends p9
+        for (let i = 0; i < 10; i++) {
+            const body = {};
+            if (i < 9)
+                body.extends = `p${i + 1}`;
+            writeProfile(root, `p${i}`, body);
+        }
+        const res = resolveProfile(root, 'p0');
+        expect(res.ok).toBe(false);
+        if (res.ok)
+            return;
+        expect(res.reason).toMatch(/max profile depth exceeded/);
+        expect(MAX_PROFILE_DEPTH).toBe(8);
+    });
+    it('3-level default → team → feature with mixed merge flags folds in order', () => {
+        root = makeProject();
+        writeProfile(root, 'default', {
+            obligations: [{ id: 'a', title: 'A', text: 'p', severity: 'must' }],
+        });
+        writeProfile(root, 'team', {
+            extends: 'default',
+            merge_obligations: true,
+            obligations: [{ id: 'b', title: 'B', text: 'p', severity: 'must' }],
+        });
+        writeProfile(root, 'feature', {
+            extends: 'team',
+            merge_obligations: true,
+            obligations: [{ id: 'c', title: 'C', text: 'p', severity: 'must' }],
+        });
+        const res = resolveProfile(root, 'feature');
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.chain).toEqual(['default', 'team', 'feature']);
+        const ids = res.resolved.obligations.map((o) => o.id).sort();
+        expect(ids).toEqual(['a', 'b', 'c']);
+    });
+    it('merge_conventions / merge_tooling shallow-merge child-wins per key', () => {
+        root = makeProject();
+        writeProfile(root, 'default', {
+            conventions: { imports: 'extension', other: 'keep' },
+            tooling: { linter: 'eslint', test: 'jest' },
+        });
+        writeProfile(root, 'team', {
+            extends: 'default',
+            merge_conventions: true,
+            merge_tooling: true,
+            conventions: { imports: 'extensionless' }, // override one key
+            tooling: { linter: 'biome' },
+        });
+        const res = resolveProfile(root, 'team');
+        expect(res.ok).toBe(true);
+        if (!res.ok)
+            return;
+        expect(res.resolved.conventions).toEqual({ imports: 'extensionless', other: 'keep' });
+        expect(res.resolved.tooling).toEqual({ linter: 'biome', test: 'jest' });
+    });
+});
+//# sourceMappingURL=profile-resolve.test.js.map