@organon-methodology/tools 0.3.0

package/dist/core/meta-invariants.test.js.map

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

package/dist/core/node-fs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * NodeFileSystem — concrete FileSystem implementation using Node.js APIs.
+ *
+ * Used by CLI and MCP server for real I/O. Core functions receive the
+ * FileSystem interface, not this class directly.
+ */
+import type { FileSystem, FileStat } from './types.js';
+export declare class NodeFileSystem implements FileSystem {
+    readFile(filePath: string): Promise<string>;
+    readDir(dirPath: string): Promise<string[]>;
+    exists(filePath: string): Promise<boolean>;
+    glob(pattern: string, options?: {
+        cwd: string;
+        ignore?: string[];
+    }): Promise<string[]>;
+    stat(filePath: string): Promise<FileStat>;
+}
+/**
+ * Resolve a potentially relative path against a base directory.
+ */
+export declare function resolvePath(base: string, relative: string): string;
+//# sourceMappingURL=node-fs.d.ts.map

package/dist/core/node-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.d.ts","sourceRoot":"","sources":["../../src/core/node-fs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD,qBAAa,cAAe,YAAW,UAAU;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK3C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C,IAAI,CACR,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3C,OAAO,CAAC,MAAM,EAAE,CAAC;IAUd,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAIhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/core/node-fs.js

@@ -0,0 +1,47 @@
+/**
+ * NodeFileSystem — concrete FileSystem implementation using Node.js APIs.
+ *
+ * Used by CLI and MCP server for real I/O. Core functions receive the
+ * FileSystem interface, not this class directly.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { glob as globFn } from 'glob';
+export class NodeFileSystem {
+    async readFile(filePath) {
+        return fs.readFile(filePath, 'utf-8');
+    }
+    async readDir(dirPath) {
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        return entries.map((e) => e.name);
+    }
+    async exists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async glob(pattern, options) {
+        const results = await globFn(pattern, {
+            cwd: options?.cwd,
+            ignore: options?.ignore,
+            nodir: true,
+            posix: true,
+        });
+        return results;
+    }
+    async stat(filePath) {
+        const s = await fs.stat(filePath);
+        return { mtime: s.mtime, size: s.size };
+    }
+}
+/**
+ * Resolve a potentially relative path against a base directory.
+ */
+export function resolvePath(base, relative) {
+    return path.resolve(base, relative);
+}
+//# sourceMappingURL=node-fs.js.map

package/dist/core/node-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.js","sourceRoot":"","sources":["../../src/core/node-fs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAGtC,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,OAAe,EACf,OAA4C;QAE5C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE;YACpC,GAAG,EAAE,OAAO,EAAE,GAAG;YACjB,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,QAAgB;IACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/dist/core/organon-invariants.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Dogfood tests: @organon-methodology/testing used inside @organon-methodology/tools.
+ *
+ * These tests exercise the @organon-methodology/testing library against real source files
+ * in this package, proving the API works end-to-end from a consumer perspective.
+ *
+ * @organon-invariant INV-TOOLS-1 schema-fidelity
+ * @organon-invariant INV-TOOLS-2 every-command-has-tests
+ * @organon-invariant INV-TOOLS-3 gates-fail-not-warn
+ * @organon-invariant INV-TOOLS-4 machine-parsable-output
+ * @organon-invariant INV-TOOLS-5 idempotent-operations
+ * @organon-invariant INV-TOOLS-6 breaking-changes-major-version
+ */
+export {};
+//# sourceMappingURL=organon-invariants.test.d.ts.map

package/dist/core/organon-invariants.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organon-invariants.test.d.ts","sourceRoot":"","sources":["../../src/core/organon-invariants.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/core/organon-invariants.test.js

@@ -0,0 +1,149 @@
+/**
+ * Dogfood tests: @organon-methodology/testing used inside @organon-methodology/tools.
+ *
+ * These tests exercise the @organon-methodology/testing library against real source files
+ * in this package, proving the API works end-to-end from a consumer perspective.
+ *
+ * @organon-invariant INV-TOOLS-1 schema-fidelity
+ * @organon-invariant INV-TOOLS-2 every-command-has-tests
+ * @organon-invariant INV-TOOLS-3 gates-fail-not-warn
+ * @organon-invariant INV-TOOLS-4 machine-parsable-output
+ * @organon-invariant INV-TOOLS-5 idempotent-operations
+ * @organon-invariant INV-TOOLS-6 breaking-changes-major-version
+ */
+import { describe } from 'vitest';
+import { testInvariant, assertMaxValue } from '@organon-methodology/testing/vitest';
+import { resolve } from 'node:path';
+import { readdir, readFile } from 'node:fs/promises';
+import { validateFrontmatter } from './validate-frontmatter.js';
+import { validateWorkflow } from './validate-workflow.js';
+import { MemoryFileSystem, makeEthos } from './test-helpers.js';
+const coreDir = resolve(import.meta.dirname, '.');
+describe('@organon-methodology/testing dogfood — tools invariant verification', () => {
+    // -------------------------------------------------------------------------
+    // INV-TOOLS-1: schema-fidelity — MAX_SUMMARY_LENGTH ≤ 200
+    // -------------------------------------------------------------------------
+    testInvariant('INV-TOOLS-1', 'MAX_SUMMARY_LENGTH does not exceed 200 characters', async () => {
+        await assertMaxValue({
+            files: ['src/core/validate-frontmatter.ts'],
+            pattern: /MAX_SUMMARY_LENGTH\s*=\s*(\d+)/,
+            maxValue: 200,
+            unit: 'characters',
+            cwd: resolve(coreDir, '../..'),
+        });
+    });
+    // -------------------------------------------------------------------------
+    // INV-TOOLS-1: schema-fidelity — TOKEN_TOLERANCE ≤ 2.0
+    // -------------------------------------------------------------------------
+    testInvariant('INV-TOOLS-1', 'TOKEN_TOLERANCE stays within reasonable bounds (max 2.0)', async () => {
+        await assertMaxValue({
+            files: ['src/core/validate-frontmatter.ts'],
+            pattern: /TOKEN_TOLERANCE\s*=\s*([\d.]+)/,
+            maxValue: 2.0,
+            unit: 'ratio',
+            cwd: resolve(coreDir, '../..'),
+        });
+    });
+    // -------------------------------------------------------------------------
+    // INV-TOOLS-2: every-command-has-tests — core/ has ≥ 5 test files
+    // -------------------------------------------------------------------------
+    testInvariant('INV-TOOLS-2', 'core/ directory has at least 5 test files', async () => {
+        const entries = await readdir(coreDir);
+        const testFiles = entries.filter((f) => f.endsWith('.test.ts'));
+        if (testFiles.length < 5) {
+            throw new Error(`Expected at least 5 test files in core/, found ${testFiles.length}: ${testFiles.join(', ')}`);
+        }
+    });
+    // -------------------------------------------------------------------------
+    // INV-TOOLS-3: gates-fail-not-warn — gate errors use 'error' severity
+    // -------------------------------------------------------------------------
+    testInvariant('INV-TOOLS-3', 'verification gates produce errors (not warnings) for blocking checks', async () => {
+        // A workflow missing required fields should produce errors, not warnings
+        const fs = new MemoryFileSystem({
+            '/project/workflows/bad.md': '# No frontmatter',
+        });
+        const config = {
+            projectRoot: '/project',
+            organonPaths: ['.'],
+            organonGlobs: ['**/ETHOS.md'],
+            ignorePatterns: [],
+            workflowPaths: { generic: 'workflows' },
+            freshnessThresholdHours: 24,
+        };
+        const result = await validateWorkflow({ projectRoot: '/project', config, fs });
+        // Must fail (not just warn)
+        if (result.success) {
+            throw new Error('Gate should fail for invalid workflow, not silently pass');
+        }
+        // All blocking issues must be errors, not warnings
+        for (const err of result.errors) {
+            if (err.severity !== 'error') {
+                throw new Error(`Blocking diagnostic ${err.code} has severity '${err.severity}', expected 'error'`);
+            }
+        }
+    });
+    // -------------------------------------------------------------------------
+    // INV-TOOLS-4: machine-parsable-output — results are structured objects
+    // -------------------------------------------------------------------------
+    testInvariant('INV-TOOLS-4', 'validation results are structured objects with success/errors fields', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos(),
+        });
+        const config = {
+            projectRoot: '/project',
+            organonPaths: ['.'],
+            organonGlobs: ['**/ETHOS.md'],
+            ignorePatterns: [],
+            workflowPaths: {},
+            freshnessThresholdHours: 24,
+        };
+        const result = await validateFrontmatter({ projectRoot: '/project', config, fs });
+        // Result must have structured fields for programmatic consumption
+        if (typeof result.success !== 'boolean') {
+            throw new Error('Result must have boolean success field');
+        }
+        if (!Array.isArray(result.errors)) {
+            throw new Error('Result must have errors array');
+        }
+        if (!Array.isArray(result.warnings)) {
+            throw new Error('Result must have warnings array');
+        }
+    });
+    // -------------------------------------------------------------------------
+    // INV-TOOLS-5: idempotent-operations — same input → same output
+    // -------------------------------------------------------------------------
+    testInvariant('INV-TOOLS-5', 're-running validation with identical input produces identical output', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos(),
+        });
+        const config = {
+            projectRoot: '/project',
+            organonPaths: ['.'],
+            organonGlobs: ['**/ETHOS.md'],
+            ignorePatterns: [],
+            workflowPaths: {},
+            freshnessThresholdHours: 24,
+        };
+        const opts = { projectRoot: '/project', config, fs };
+        const result1 = await validateFrontmatter(opts);
+        const result2 = await validateFrontmatter(opts);
+        if (result1.success !== result2.success) {
+            throw new Error('Idempotency violated: success differs between runs');
+        }
+        if (result1.errors.length !== result2.errors.length) {
+            throw new Error('Idempotency violated: error count differs between runs');
+        }
+    });
+    // -------------------------------------------------------------------------
+    // INV-TOOLS-6: breaking-changes-major-version — version is semver
+    // -------------------------------------------------------------------------
+    testInvariant('INV-TOOLS-6', 'package.json version follows semver format', async () => {
+        const pkgPath = resolve(coreDir, '../../package.json');
+        const pkgJson = JSON.parse(await readFile(pkgPath, 'utf-8'));
+        const semverRe = /^\d+\.\d+\.\d+/;
+        if (!semverRe.test(pkgJson.version)) {
+            throw new Error(`Version "${pkgJson.version}" does not follow semver`);
+        }
+    });
+});
+//# sourceMappingURL=organon-invariants.test.js.map

package/dist/core/organon-invariants.test.js.map

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

package/dist/core/query.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Query organon files by frontmatter metadata.
+ *
+ * Supports filtering by scope, type, priority, task, budget, name pattern,
+ * and related entities. Returns matching files with frontmatter and total
+ * token cost for context budget planning.
+ */
+import type { FileSystem, FrontmatterScope, FrontmatterType, LoadPriority, OrganonConfig, QueryResult } from './types.js';
+export interface QueryOptions {
+    projectRoot: string;
+    config: OrganonConfig;
+    fs: FileSystem;
+    /** Filter by scope */
+    scope?: FrontmatterScope;
+    /** Filter by type */
+    type?: FrontmatterType;
+    /** Filter by load_priority */
+    priority?: LoadPriority;
+    /** Filter by required_for containing this task */
+    task?: string;
+    /** Maximum total token budget — stops adding files when budget exceeded */
+    budget?: number;
+    /** Filter by name pattern (substring match) */
+    namePattern?: string;
+    /** Filter by related domain name */
+    relatedDomain?: string;
+    /** Filter by related feature name */
+    relatedFeature?: string;
+    /** Include files without frontmatter in results */
+    includeInvalid?: boolean;
+    /** Return full file content (body) or just frontmatter */
+    verbose?: boolean;
+}
+export declare function query(options: QueryOptions): Promise<QueryResult>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/core/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAEV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,EAEb,WAAW,EACZ,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,UAAU,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,qBAAqB;IACrB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkIvE"}

package/dist/core/query.js

@@ -0,0 +1,139 @@
+/**
+ * Query organon files by frontmatter metadata.
+ *
+ * Supports filtering by scope, type, priority, task, budget, name pattern,
+ * and related entities. Returns matching files with frontmatter and total
+ * token cost for context budget planning.
+ */
+import { parseOrganonFile } from './frontmatter-parser.js';
+import { joinPath } from './config.js';
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+export async function query(options) {
+    const { projectRoot, config, fs } = options;
+    const errors = [];
+    const warnings = [];
+    // Discover all organon files
+    const allFiles = await discoverOrganonFiles(projectRoot, config, fs);
+    // Parse frontmatter for all files
+    const parsed = [];
+    for (const file of allFiles) {
+        const absPath = joinPath(projectRoot, file);
+        try {
+            const content = await fs.readFile(absPath);
+            parsed.push(parseOrganonFile(file, content));
+        }
+        catch {
+            errors.push({
+                severity: 'error',
+                code: 'FILE_READ_ERROR',
+                message: `Cannot read file: ${file}`,
+                file,
+            });
+        }
+    }
+    // Apply filters
+    let filtered = parsed;
+    // Filter out files without frontmatter (unless includeInvalid)
+    if (!options.includeInvalid) {
+        filtered = filtered.filter((f) => f.frontmatter !== null);
+    }
+    // Filter by scope
+    if (options.scope) {
+        filtered = filtered.filter((f) => f.frontmatter?.scope === options.scope);
+    }
+    // Filter by type
+    if (options.type) {
+        filtered = filtered.filter((f) => f.frontmatter?.type === options.type);
+    }
+    // Filter by priority
+    if (options.priority) {
+        filtered = filtered.filter((f) => f.frontmatter?.load_priority === options.priority);
+    }
+    // Filter by task (required_for)
+    if (options.task) {
+        filtered = filtered.filter((f) => f.frontmatter?.required_for?.includes(options.task));
+    }
+    // Filter by name pattern
+    if (options.namePattern) {
+        const pattern = options.namePattern.toLowerCase();
+        filtered = filtered.filter((f) => f.frontmatter?.name?.toLowerCase().includes(pattern));
+    }
+    // Filter by related domain
+    if (options.relatedDomain) {
+        filtered = filtered.filter((f) => f.frontmatter?.related_domains?.includes(options.relatedDomain) ||
+            f.frontmatter?.name === options.relatedDomain);
+    }
+    // Filter by related feature
+    if (options.relatedFeature) {
+        filtered = filtered.filter((f) => f.frontmatter?.related_features?.includes(options.relatedFeature) ||
+            f.frontmatter?.name === options.relatedFeature);
+    }
+    // Sort by load_priority (high first), then by token_estimate (smallest first)
+    filtered.sort((a, b) => {
+        const priorityOrder = { high: 0, medium: 1, low: 2 };
+        const aPri = priorityOrder[a.frontmatter?.load_priority ?? 'medium'];
+        const bPri = priorityOrder[b.frontmatter?.load_priority ?? 'medium'];
+        if (aPri !== bPri)
+            return aPri - bPri;
+        return (a.frontmatter?.token_estimate ?? 0) - (b.frontmatter?.token_estimate ?? 0);
+    });
+    // Apply budget constraint
+    if (options.budget) {
+        let tokenSum = 0;
+        const budgetFiltered = [];
+        for (const f of filtered) {
+            const tokens = f.frontmatter?.token_estimate ?? 0;
+            if (tokenSum + tokens <= options.budget) {
+                budgetFiltered.push(f);
+                tokenSum += tokens;
+            }
+            else {
+                warnings.push({
+                    severity: 'warning',
+                    code: 'BUDGET_EXCEEDED',
+                    message: `Skipping '${f.path}' (${tokens} tokens) — would exceed budget of ${options.budget}`,
+                    file: f.path,
+                });
+            }
+        }
+        filtered = budgetFiltered;
+    }
+    // Strip body content if not verbose
+    if (!options.verbose) {
+        filtered = filtered.map((f) => ({
+            ...f,
+            body: '',
+            content: '',
+        }));
+    }
+    const totalTokens = filtered.reduce((sum, f) => sum + (f.frontmatter?.token_estimate ?? 0), 0);
+    return {
+        success: errors.length === 0,
+        files: filtered,
+        totalTokens,
+        errors,
+        warnings,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function discoverOrganonFiles(projectRoot, config, fs) {
+    const allFiles = new Set();
+    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 m of matches) {
+                allFiles.add(m);
+            }
+        }
+    }
+    return [...allFiles].sort();
+}
+//# sourceMappingURL=query.js.map

package/dist/core/query.js.map

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

package/dist/core/query.test.d.ts

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

package/dist/core/query.test.d.ts.map

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

package/dist/core/query.test.js

@@ -0,0 +1,97 @@
+import { describe, it, expect } from 'vitest';
+import { query } from './query.js';
+import { MemoryFileSystem, makeEthos, makePhilosophy, makeReadme } from './test-helpers.js';
+function makeConfig(projectRoot) {
+    return {
+        projectRoot,
+        organonPaths: ['.'],
+        organonGlobs: ['**/ETHOS.md', '**/PHILOSOPHY.md', '**/PROTOCOLS.md', '**/README.md'],
+        ignorePatterns: [],
+        workflowPaths: {},
+        freshnessThresholdHours: 24,
+    };
+}
+describe('query', () => {
+    const ethosContent = makeEthos({ name: 'genesis', scope: 'domain', extra: { load_priority: 'high', 'required_for': '[genesis_impl]' } });
+    const philContent = makePhilosophy({ name: 'genesis-phil' });
+    const readmeContent = makeReadme({ name: 'root', scope: 'product' });
+    function makeFs() {
+        return new MemoryFileSystem({
+            '/project/organon/domains/genesis/ETHOS.md': ethosContent,
+            '/project/organon/domains/genesis/PHILOSOPHY.md': philContent,
+            '/project/README.md': readmeContent,
+        });
+    }
+    it('returns all files with frontmatter by default', async () => {
+        const fs = makeFs();
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs });
+        expect(result.success).toBe(true);
+        expect(result.files.length).toBe(3);
+    });
+    it('filters by scope', async () => {
+        const fs = makeFs();
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs, scope: 'domain' });
+        expect(result.files.length).toBe(2); // genesis ETHOS + PHILOSOPHY
+        expect(result.files.every((f) => f.frontmatter?.scope === 'domain')).toBe(true);
+    });
+    it('filters by type', async () => {
+        const fs = makeFs();
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs, type: 'constraints' });
+        expect(result.files.length).toBe(1);
+        expect(result.files[0].frontmatter?.type).toBe('constraints');
+    });
+    it('filters by name pattern', async () => {
+        const fs = makeFs();
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs, namePattern: 'genesis' });
+        expect(result.files.length).toBe(2);
+    });
+    it('respects token budget', async () => {
+        const fs = makeFs();
+        const config = makeConfig('/project');
+        // Budget of 200 tokens - should only fit small files
+        const result = await query({ projectRoot: '/project', config, fs, budget: 200 });
+        expect(result.totalTokens).toBeLessThanOrEqual(200);
+        expect(result.warnings.some((w) => w.code === 'BUDGET_EXCEEDED')).toBe(true);
+    });
+    it('calculates total tokens', async () => {
+        const fs = makeFs();
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs });
+        expect(result.totalTokens).toBeGreaterThan(0);
+    });
+    it('strips body in non-verbose mode', async () => {
+        const fs = makeFs();
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs, verbose: false });
+        expect(result.files.every((f) => f.body === '')).toBe(true);
+    });
+    it('includes body in verbose mode', async () => {
+        const fs = makeFs();
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs, verbose: true });
+        expect(result.files.some((f) => f.body.length > 0)).toBe(true);
+    });
+    it('excludes files without frontmatter by default', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+            '/project/README.md': '# No frontmatter',
+        });
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs });
+        expect(result.files.length).toBe(1);
+    });
+    it('includes invalid files when requested', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+            '/project/README.md': '# No frontmatter',
+        });
+        const config = makeConfig('/project');
+        const result = await query({ projectRoot: '/project', config, fs, includeInvalid: true });
+        expect(result.files.length).toBe(2);
+    });
+});
+//# sourceMappingURL=query.test.js.map

package/dist/core/query.test.js.map

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

package/dist/core/suggest-tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Automation suggestion heuristics.
+ *
+ * Analyzes protocols and suggests which ones should be upgraded
+ * from manual → semi-automated → automated, based on step count,
+ * complexity, frequency indicators, and error-proneness.
+ */
+import type { FileSystem, OrganonConfig, SuggestToolsResult } from './types.js';
+export interface SuggestToolsOptions {
+    projectRoot: string;
+    config: OrganonConfig;
+    fs: FileSystem;
+}
+export declare function suggestTools(options: SuggestToolsOptions): Promise<SuggestToolsResult>;
+//# sourceMappingURL=suggest-tools.d.ts.map

package/dist/core/suggest-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-tools.d.ts","sourceRoot":"","sources":["../../src/core/suggest-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAIV,UAAU,EACV,aAAa,EACb,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,UAAU,CAAC;CAChB;AA2BD,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA6C7B"}