@organon-methodology/tools 0.3.0

package/dist/core/generate-frontmatter.test.js

@@ -0,0 +1,161 @@
+import { describe, it, expect } from 'vitest';
+import { generateFrontmatter, serializeFrontmatter } from './generate-frontmatter.js';
+import { MemoryFileSystem, makeEthos } from './test-helpers.js';
+function makeConfig(projectRoot) {
+    return {
+        projectRoot,
+        organonPaths: ['.'],
+        organonGlobs: ['**/ETHOS.md'],
+        ignorePatterns: [],
+        workflowPaths: {},
+        freshnessThresholdHours: 24,
+    };
+}
+describe('generateFrontmatter', () => {
+    it('infers type from filename', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': '# Test\n\n## Identity\n\n## Invariants\n\n1. **Rule.** Desc.',
+        });
+        const config = makeConfig('/project');
+        const result = await generateFrontmatter({
+            projectRoot: '/project',
+            config,
+            fs,
+            file: 'ETHOS.md',
+        });
+        expect(result.generated.type).toBe('constraints');
+    });
+    it('infers scope from path', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/organon/domains/genesis/ETHOS.md': '# Genesis\n\n## Invariants\n\n1. **Rule.** Desc.',
+        });
+        const config = makeConfig('/project');
+        const result = await generateFrontmatter({
+            projectRoot: '/project',
+            config,
+            fs,
+            file: 'organon/domains/genesis/ETHOS.md',
+        });
+        expect(result.generated.scope).toBe('domain');
+    });
+    it('infers name from parent directory', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/organon/domains/genesis/ETHOS.md': '# Genesis\n\n## Invariants\n\n1. **Rule.** Desc.',
+        });
+        const config = makeConfig('/project');
+        const result = await generateFrontmatter({
+            projectRoot: '/project',
+            config,
+            fs,
+            file: 'organon/domains/genesis/ETHOS.md',
+        });
+        expect(result.generated.name).toBe('genesis');
+    });
+    it('counts invariants and principles for constraints type', async () => {
+        const content = `# Test
+
+## Invariants
+
+1. **Rule one.** First.
+2. **Rule two.** Second.
+3. **Rule three.** Third.
+
+## Principles (Prioritized)
+
+1. **Principle one.** First.
+2. **Principle two.** Second.
+
+## Decision Heuristics
+
+| Situation | Action |
+|-----------|--------|
+| When X | Do Y |
+`;
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': content,
+        });
+        const config = makeConfig('/project');
+        const result = await generateFrontmatter({
+            projectRoot: '/project',
+            config,
+            fs,
+            file: 'ETHOS.md',
+        });
+        expect(result.generated.invariants_count).toBe(3);
+        expect(result.generated.principles_count).toBe(2);
+        expect(result.generated.heuristics_count).toBe(1);
+    });
+    it('preserves existing relationship fields', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({
+                name: 'test',
+                scope: 'domain',
+                extra: {
+                    'inherits_from': '[product]',
+                    'related_domains': '[other]',
+                    load_priority: 'high',
+                },
+            }),
+        });
+        const config = makeConfig('/project');
+        const result = await generateFrontmatter({
+            projectRoot: '/project',
+            config,
+            fs,
+            file: 'ETHOS.md',
+        });
+        expect(result.generated.inherits_from).toEqual(['product']);
+        expect(result.generated.related_domains).toEqual(['other']);
+        expect(result.generated.load_priority).toBe('high');
+    });
+    it('allows type override', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/custom.md': '# Custom\n\nContent.',
+        });
+        const config = makeConfig('/project');
+        config.organonGlobs = ['**/*.md'];
+        const result = await generateFrontmatter({
+            projectRoot: '/project',
+            config,
+            fs,
+            file: 'custom.md',
+            type: 'rationale',
+        });
+        expect(result.generated.type).toBe('rationale');
+    });
+    it('calculates token estimate', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos(),
+        });
+        const config = makeConfig('/project');
+        const result = await generateFrontmatter({
+            projectRoot: '/project',
+            config,
+            fs,
+            file: 'ETHOS.md',
+        });
+        expect(result.generated.token_estimate).toBeGreaterThan(0);
+    });
+    it('returns error for missing file', async () => {
+        const fs = new MemoryFileSystem();
+        const config = makeConfig('/project');
+        const result = await generateFrontmatter({
+            projectRoot: '/project',
+            config,
+            fs,
+            file: 'nonexistent.md',
+        });
+        expect(result.success).toBe(false);
+        expect(result.errors).toContainEqual(expect.objectContaining({ code: 'FILE_READ_ERROR' }));
+    });
+});
+describe('serializeFrontmatter', () => {
+    it('produces valid YAML with delimiters', () => {
+        const yaml = serializeFrontmatter({ type: 'constraints', name: 'test' });
+        expect(yaml).toMatch(/^---\n/);
+        expect(yaml).toMatch(/---\n$/);
+        expect(yaml).toContain('type: constraints');
+        expect(yaml).toContain('name: test');
+    });
+});
+//# sourceMappingURL=generate-frontmatter.test.js.map

package/dist/core/generate-frontmatter.test.js.map

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

package/dist/core/generate-tests.d.ts

@@ -0,0 +1,41 @@
+/**
+ * generate-tests — Find uncovered invariants and generate test scaffolds.
+ *
+ * Scans organon files for invariant declarations, checks which ones
+ * already have tests (via @organon-invariant annotations), and generates
+ * test scaffold files for uncovered invariants using heuristic assertion matching.
+ */
+import { type ExtractedInvariant } from './invariant-coverage.js';
+import type { FileSystem, OrganonConfig } from './types.js';
+export interface GenerateTestsOptions {
+    projectRoot: string;
+    config: OrganonConfig;
+    fs: FileSystem;
+    /** If set, only generate for these invariant IDs */
+    invariantIds?: string[];
+    /** Directory to write generated test files */
+    outDir?: string;
+}
+export interface GeneratedTest {
+    /** The invariant this test covers */
+    invariant: ExtractedInvariant;
+    /** Suggested assertion function */
+    assertion: string;
+    /** Generated test scaffold code */
+    code: string;
+    /** Suggested filename */
+    filename: string;
+}
+export interface GenerateTestsResult {
+    /** Tests generated for uncovered invariants */
+    generated: GeneratedTest[];
+    /** Invariants that already have test coverage */
+    alreadyCovered: ExtractedInvariant[];
+    /** Invariants marked as judgment calls */
+    judgmentCalls: ExtractedInvariant[];
+}
+/**
+ * Generate test scaffolds for uncovered invariants.
+ */
+export declare function generateTests(options: GenerateTestsOptions): Promise<GenerateTestsResult>;
+//# sourceMappingURL=generate-tests.d.ts.map

package/dist/core/generate-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.d.ts","sourceRoot":"","sources":["../../src/core/generate-tests.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,UAAU,EAEV,aAAa,EACd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,UAAU,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,iDAAiD;IACjD,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,0CAA0C;IAC1C,aAAa,EAAE,kBAAkB,EAAE,CAAC;CACrC;AA4ID;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAyE9B"}

package/dist/core/generate-tests.js

@@ -0,0 +1,191 @@
+/**
+ * generate-tests — Find uncovered invariants and generate test scaffolds.
+ *
+ * Scans organon files for invariant declarations, checks which ones
+ * already have tests (via @organon-invariant annotations), and generates
+ * test scaffold files for uncovered invariants using heuristic assertion matching.
+ */
+import { parseFrontmatter } from './frontmatter-parser.js';
+import { joinPath } from './config.js';
+import { extractInvariants, scanTestAnnotations, } from './invariant-coverage.js';
+function matchAssertion(invariant) {
+    const name = invariant.name.toLowerCase();
+    const id = invariant.id.toLowerCase();
+    const combined = `${name} ${id}`;
+    if (/max|limit|threshold|ceiling|bound/.test(combined)) {
+        return {
+            assertion: 'assertMaxValue',
+            scaffold: (inv) => scaffoldMaxValue(inv),
+        };
+    }
+    if (/pure|side.?effect|no.?io|no.?import/.test(combined)) {
+        return {
+            assertion: 'assertNoSideEffects',
+            scaffold: (inv) => scaffoldNoSideEffects(inv),
+        };
+    }
+    if (/naming|convention|case|kebab|camel|pascal|snake/.test(combined)) {
+        return {
+            assertion: 'assertNamingConvention',
+            scaffold: (inv) => scaffoldNamingConvention(inv),
+        };
+    }
+    if (/exist|present|require|file/.test(combined)) {
+        return {
+            assertion: 'assertFileExists',
+            scaffold: (inv) => scaffoldFileExists(inv),
+        };
+    }
+    return {
+        assertion: 'assertCustom',
+        scaffold: (inv) => scaffoldCustom(inv),
+    };
+}
+// ---------------------------------------------------------------------------
+// Scaffold templates
+// ---------------------------------------------------------------------------
+function testFileHeader(inv) {
+    return `// @organon-invariant ${inv.id}
+import { describe } from 'vitest';
+import { testInvariant } from '@organon-methodology/testing/vitest';
+`;
+}
+function scaffoldMaxValue(inv) {
+    return `${testFileHeader(inv)}import { assertMaxValue } from '@organon-methodology/testing/vitest';
+
+describe('${inv.id}', () => {
+  testInvariant('${inv.id}', '${inv.name}', async () => {
+    await assertMaxValue({
+      files: ['src/**/*.ts'],   // TODO: adjust file pattern
+      pattern: /TODO_PATTERN/,  // TODO: regex with capturing group for numeric value
+      maxValue: 100,            // TODO: set appropriate maximum
+      unit: 'TODO',             // TODO: set unit (e.g., 'lines', 'seconds')
+    });
+  });
+});
+`;
+}
+function scaffoldNoSideEffects(inv) {
+    return `${testFileHeader(inv)}import { assertNoSideEffects } from '@organon-methodology/testing/vitest';
+
+describe('${inv.id}', () => {
+  testInvariant('${inv.id}', '${inv.name}', async () => {
+    await assertNoSideEffects({
+      files: ['src/**/*.ts'],                 // TODO: adjust file pattern
+      forbiddenModules: ['fs', 'http'],       // TODO: adjust forbidden modules
+    });
+  });
+});
+`;
+}
+function scaffoldFileExists(inv) {
+    return `${testFileHeader(inv)}import { assertFileExists } from '@organon-methodology/testing/vitest';
+
+describe('${inv.id}', () => {
+  testInvariant('${inv.id}', '${inv.name}', async () => {
+    await assertFileExists({
+      files: ['TODO/path/to/required-file.ts'],  // TODO: list required files
+    });
+  });
+});
+`;
+}
+function scaffoldNamingConvention(inv) {
+    return `${testFileHeader(inv)}import { assertNamingConvention } from '@organon-methodology/testing/vitest';
+
+describe('${inv.id}', () => {
+  testInvariant('${inv.id}', '${inv.name}', async () => {
+    await assertNamingConvention({
+      mode: 'filenames',              // TODO: 'filenames' or 'identifiers'
+      files: ['src/**/*.ts'],         // TODO: adjust file pattern
+      convention: 'kebab-case',       // TODO: adjust convention
+    });
+  });
+});
+`;
+}
+function scaffoldCustom(inv) {
+    return `${testFileHeader(inv)}import { assertCustom } from '@organon-methodology/testing/vitest';
+
+describe('${inv.id}', () => {
+  testInvariant('${inv.id}', '${inv.name}', async () => {
+    await assertCustom({
+      label: '${inv.name}',
+      validate: async () => {
+        // TODO: implement custom validation logic
+        throw new Error('Not implemented');
+      },
+    });
+  });
+});
+`;
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+/**
+ * Generate test scaffolds for uncovered invariants.
+ */
+export async function generateTests(options) {
+    const { projectRoot, config, fs, invariantIds } = options;
+    // 1. Discover organon files and extract invariants
+    const seenPaths = new Set();
+    const parsedFiles = [];
+    for (const organonPath of config.organonPaths) {
+        for (const pattern of config.organonGlobs) {
+            const fullPattern = organonPath === '.' ? pattern : `${organonPath}/${pattern}`;
+            const matches = await fs.glob(fullPattern, {
+                cwd: projectRoot,
+                ignore: config.ignorePatterns,
+            });
+            for (const file of matches) {
+                if (seenPaths.has(file))
+                    continue;
+                seenPaths.add(file);
+                const absPath = joinPath(projectRoot, file);
+                try {
+                    const content = await fs.readFile(absPath);
+                    const { frontmatter } = parseFrontmatter(content);
+                    parsedFiles.push({ path: file, frontmatter });
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+        }
+    }
+    const allInvariants = extractInvariants(parsedFiles);
+    // 2. Filter by requested IDs if specified
+    const targetInvariants = invariantIds
+        ? allInvariants.filter((inv) => invariantIds.includes(inv.id))
+        : allInvariants;
+    // 3. Scan for existing test annotations
+    const annotations = await scanTestAnnotations(fs, projectRoot, config);
+    // 4. Categorize invariants
+    const generated = [];
+    const alreadyCovered = [];
+    const judgmentCalls = [];
+    for (const inv of targetInvariants) {
+        if (inv.judgment_call) {
+            judgmentCalls.push(inv);
+            continue;
+        }
+        const existingTests = annotations.get(inv.id) ?? [];
+        if (existingTests.length > 0) {
+            alreadyCovered.push(inv);
+            continue;
+        }
+        // Generate scaffold
+        const template = matchAssertion(inv);
+        const code = template.scaffold(inv);
+        const filename = `${inv.id.toLowerCase().replace(/[^a-z0-9]+/g, '-')}.test.ts`;
+        generated.push({
+            invariant: inv,
+            assertion: template.assertion,
+            code,
+            filename,
+        });
+    }
+    return { generated, alreadyCovered, judgmentCalls };
+}
+//# sourceMappingURL=generate-tests.js.map

package/dist/core/generate-tests.js.map

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

package/dist/core/generate-tests.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generate-tests.test.d.ts.map

package/dist/core/generate-tests.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.test.d.ts","sourceRoot":"","sources":["../../src/core/generate-tests.test.ts"],"names":[],"mappings":""}

package/dist/core/generate-tests.test.js

@@ -0,0 +1,205 @@
+import { describe, it, expect } from 'vitest';
+import { generateTests } from './generate-tests.js';
+import { MemoryFileSystem, makeEthos } from './test-helpers.js';
+const PROJECT_ROOT = '/project';
+function makeConfig(overrides) {
+    return {
+        projectRoot: PROJECT_ROOT,
+        organonPaths: ['.'],
+        organonGlobs: ['**/ETHOS.md'],
+        ignorePatterns: ['node_modules/**'],
+        workflowPaths: {},
+        freshnessThresholdHours: 720,
+        ...overrides,
+    };
+}
+function makeEthosWithInvariants(invariants) {
+    const invYaml = invariants.map((inv) => {
+        const jc = inv.judgment_call ? `\n    judgment_call: true` : '';
+        return `  - id: ${inv.id}\n    name: ${inv.name}${jc}`;
+    }).join('\n');
+    return `---
+type: constraints
+scope: domain
+name: test-domain
+version: "1.0"
+summary: Test ethos
+token_estimate: 500
+invariants_count: ${invariants.length}
+principles_count: 1
+heuristics_count: 1
+invariants:
+${invYaml}
+---
+
+# Test Domain
+
+## Identity
+
+### What This IS
+- A test domain
+
+### What This IS NOT
+- Not production
+
+## Invariants
+
+1. **Rule 1.** Test rule.
+
+## Principles (Prioritized)
+
+1. **Principle 1.** Test principle.
+
+## Decision Heuristics
+
+| Situation | Action |
+|-----------|--------|
+| Test | Do test |
+`;
+}
+describe('generateTests', () => {
+    it('generates scaffolds for uncovered invariants', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-TEST-1', name: 'max-timeout' },
+            ]),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+        });
+        expect(result.generated).toHaveLength(1);
+        expect(result.generated[0].invariant.id).toBe('INV-TEST-1');
+        expect(result.generated[0].assertion).toBe('assertMaxValue');
+        expect(result.generated[0].code).toContain('assertMaxValue');
+        expect(result.generated[0].code).toContain('@organon-invariant INV-TEST-1');
+        expect(result.generated[0].filename).toBe('inv-test-1.test.ts');
+    });
+    it('skips already covered invariants', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-TEST-1', name: 'max-timeout' },
+            ]),
+            '/project/tests/my-test.test.ts': `// @organon-invariant INV-TEST-1\nconsole.log("test");`,
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig({ testGlobs: ['tests/**/*.test.ts'] }),
+            fs,
+        });
+        expect(result.generated).toHaveLength(0);
+        expect(result.alreadyCovered).toHaveLength(1);
+    });
+    it('separates judgment calls', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-TEST-1', name: 'requires-human-review', judgment_call: true },
+            ]),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+        });
+        expect(result.generated).toHaveLength(0);
+        expect(result.judgmentCalls).toHaveLength(1);
+    });
+    it('matches heuristic: "pure" → assertNoSideEffects', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-TEST-1', name: 'assertion-logic-pure' },
+            ]),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+        });
+        expect(result.generated[0].assertion).toBe('assertNoSideEffects');
+    });
+    it('matches heuristic: "exists" → assertFileExists', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-TEST-1', name: 'config-file-must-exist' },
+            ]),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+        });
+        expect(result.generated[0].assertion).toBe('assertFileExists');
+    });
+    it('matches heuristic: "naming" → assertNamingConvention', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-TEST-1', name: 'file-naming-convention' },
+            ]),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+        });
+        expect(result.generated[0].assertion).toBe('assertNamingConvention');
+    });
+    it('falls back to assertCustom for unrecognized patterns', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-TEST-1', name: 'something-unusual' },
+            ]),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+        });
+        expect(result.generated[0].assertion).toBe('assertCustom');
+    });
+    it('filters by invariantIds when specified', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-A-1', name: 'max-timeout' },
+                { id: 'INV-B-1', name: 'side-effect-free' },
+                { id: 'INV-C-1', name: 'file-exists' },
+            ]),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+            invariantIds: ['INV-B-1'],
+        });
+        expect(result.generated).toHaveLength(1);
+        expect(result.generated[0].invariant.id).toBe('INV-B-1');
+    });
+    it('returns empty when no invariants defined', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ invariants: 0 }),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+        });
+        expect(result.generated).toHaveLength(0);
+        expect(result.alreadyCovered).toHaveLength(0);
+        expect(result.judgmentCalls).toHaveLength(0);
+    });
+    it('generated code includes testInvariant wrapper', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthosWithInvariants([
+                { id: 'INV-TEST-1', name: 'limit-check' },
+            ]),
+        });
+        const result = await generateTests({
+            projectRoot: PROJECT_ROOT,
+            config: makeConfig(),
+            fs,
+        });
+        expect(result.generated[0].code).toContain("testInvariant('INV-TEST-1'");
+        expect(result.generated[0].code).toContain("import { testInvariant } from '@organon-methodology/testing/vitest'");
+    });
+});
+//# sourceMappingURL=generate-tests.test.js.map

package/dist/core/generate-tests.test.js.map

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

package/dist/core/health.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Health dashboard.
+ *
+ * Reports coverage (% files with frontmatter), validation status,
+ * token analysis, freshness, and overall health score.
+ */
+import type { FileSystem, HealthResult, OrganonConfig } from './types.js';
+export interface HealthOptions {
+    projectRoot: string;
+    config: OrganonConfig;
+    fs: FileSystem;
+    /** Include fix suggestions in issues */
+    fixSuggestions?: boolean;
+}
+export declare function health(options: HealthOptions): Promise<HealthResult>;
+//# sourceMappingURL=health.d.ts.map

package/dist/core/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/core/health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAEV,UAAU,EACV,YAAY,EACZ,aAAa,EAEd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,UAAU,CAAC;IACf,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAMD,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAuI1E"}