@organon-methodology/tools 0.3.0

package/dist/core/verify.test.js

@@ -0,0 +1,147 @@
+import { describe, it, expect } from 'vitest';
+import { verify, registerGate, getRegisteredGates } from './verify.js';
+import { MemoryFileSystem, makeEthos } from './test-helpers.js';
+function makeConfig(projectRoot) {
+    return {
+        projectRoot,
+        organonPaths: ['.'],
+        organonGlobs: ['**/ETHOS.md'],
+        ignorePatterns: [],
+        workflowPaths: {},
+        freshnessThresholdHours: 24,
+    };
+}
+describe('verify', () => {
+    it('runs all built-in gates', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+        });
+        const config = makeConfig('/project');
+        const result = await verify({ projectRoot: '/project', config, fs });
+        // Should have at least the 4 built-in gates
+        expect(result.gates.length).toBeGreaterThanOrEqual(4);
+        const gateNames = result.gates.map((g) => g.gate);
+        expect(gateNames).toContain('frontmatter');
+        expect(gateNames).toContain('triplets');
+        expect(gateNames).toContain('freshness');
+        expect(gateNames).toContain('invariant-coverage');
+    });
+    it('runs a specific gate subset', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+        });
+        const config = makeConfig('/project');
+        const result = await verify({
+            projectRoot: '/project',
+            config,
+            fs,
+            gates: ['frontmatter'],
+        });
+        expect(result.gates.length).toBe(1);
+        expect(result.gates[0].gate).toBe('frontmatter');
+    });
+    it('reports error for unknown gate', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+        });
+        const config = makeConfig('/project');
+        const result = await verify({
+            projectRoot: '/project',
+            config,
+            fs,
+            gates: ['nonexistent-gate'],
+        });
+        expect(result.errors).toContainEqual(expect.objectContaining({ code: 'UNKNOWN_GATE' }));
+    });
+    it('supports custom gate registration', async () => {
+        const customGate = async () => ({
+            gate: 'custom',
+            passed: true,
+            errors: [],
+            warnings: [],
+        });
+        registerGate('custom-test', customGate);
+        expect(getRegisteredGates()).toContain('custom-test');
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+        });
+        const config = makeConfig('/project');
+        const result = await verify({
+            projectRoot: '/project',
+            config,
+            fs,
+            gates: ['custom-test'],
+        });
+        expect(result.gates.length).toBe(1);
+        expect(result.gates[0].gate).toBe('custom');
+        expect(result.gates[0].passed).toBe(true);
+    });
+    it('handles gate execution errors gracefully', async () => {
+        const failingGate = async () => {
+            throw new Error('Gate crashed');
+        };
+        registerGate('failing-test', failingGate);
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+        });
+        const config = makeConfig('/project');
+        const result = await verify({
+            projectRoot: '/project',
+            config,
+            fs,
+            gates: ['failing-test'],
+        });
+        expect(result.success).toBe(false);
+        expect(result.errors).toContainEqual(expect.objectContaining({ code: 'GATE_EXECUTION_ERROR' }));
+    });
+    it('invariant-coverage gate passes when no invariants defined', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+        });
+        const config = makeConfig('/project');
+        const result = await verify({
+            projectRoot: '/project',
+            config,
+            fs,
+            gates: ['invariant-coverage'],
+        });
+        expect(result.gates[0].gate).toBe('invariant-coverage');
+        expect(result.gates[0].passed).toBe(true);
+    });
+    it('invariant-coverage gate fails when invariants are uncovered', async () => {
+        const ethosContent = makeEthos({
+            name: 'test',
+            scope: 'product',
+            extra: {
+                invariants: `\n  - id: INV-TEST-1\n    name: rule-one`,
+            },
+        });
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': ethosContent,
+        });
+        const config = makeConfig('/project');
+        const result = await verify({
+            projectRoot: '/project',
+            config,
+            fs,
+            gates: ['invariant-coverage'],
+        });
+        expect(result.gates[0].gate).toBe('invariant-coverage');
+        expect(result.gates[0].passed).toBe(false);
+    });
+    it('success is true only when all gates pass', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
+        });
+        const config = makeConfig('/project');
+        // Frontmatter should pass on a valid file, triplets pass (no protocols), freshness is advisory
+        const result = await verify({
+            projectRoot: '/project',
+            config,
+            fs,
+            gates: ['frontmatter', 'triplets'],
+        });
+        expect(result.success).toBe(true);
+    });
+});
+//# sourceMappingURL=verify.test.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Public API for programmatic use of Organon tools.
+ *
+ * Import from '@organon-methodology/tools' or '@organon-methodology/tools/core/*'.
+ */
+export type { FileSystem, FileStat, DiagnosticMessage, Severity, Frontmatter, FrontmatterType, FrontmatterScope, AutomationTier, LoadPriority, Complexity, Audience, ProtocolEntry, InvariantEntry, ParsedOrganonFile, OrganonConfig, WorkflowPaths, ValidateFrontmatterResult, FileValidationResult, GenerateFrontmatterResult, QueryResult, HealthResult, FindResult, FindMatch, VerifyTripletsResult, TripletBinding, WorkflowValidationResult, WorkflowFileResult, SuggestToolsResult, ToolSuggestion, VerifyResult, VerifyGateResult, VerifyGateFn, InvariantCoverageResult, InvariantCoverageEntry, } from './core/types.js';
+export { resolveConfig, joinPath, dirName, baseName } from './core/config.js';
+export type { ConfigFile } from './core/config.js';
+export { NodeFileSystem, resolvePath } from './core/node-fs.js';
+export { parseFrontmatter, parseOrganonFile, estimateTokens, countSectionEntries, extractSection, countTableRows, } from './core/frontmatter-parser.js';
+export { validateFrontmatter } from './core/validate-frontmatter.js';
+export type { ValidateFrontmatterOptions } from './core/validate-frontmatter.js';
+export { generateFrontmatter, serializeFrontmatter } from './core/generate-frontmatter.js';
+export type { GenerateFrontmatterOptions } from './core/generate-frontmatter.js';
+export { query } from './core/query.js';
+export type { QueryOptions } from './core/query.js';
+export { health } from './core/health.js';
+export type { HealthOptions } from './core/health.js';
+export { find } from './core/find.js';
+export type { FindOptions } from './core/find.js';
+export { verifyTriplets } from './core/verify-triplets.js';
+export type { VerifyTripletsOptions } from './core/verify-triplets.js';
+export { suggestTools } from './core/suggest-tools.js';
+export type { SuggestToolsOptions } from './core/suggest-tools.js';
+export { verify, registerGate, getRegisteredGates } from './core/verify.js';
+export type { VerifyOptions } from './core/verify.js';
+export { computeInvariantCoverage, extractInvariants, scanTestAnnotations, computeCoverage } from './core/invariant-coverage.js';
+export { validateWorkflow } from './core/validate-workflow.js';
+export type { ValidateWorkflowOptions } from './core/validate-workflow.js';
+export { parseProtocols } from './core/add-protocols-array.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,YAAY,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3F,YAAY,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGjI,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAG3E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * Public API for programmatic use of Organon tools.
+ *
+ * Import from '@organon-methodology/tools' or '@organon-methodology/tools/core/*'.
+ */
+// Config
+export { resolveConfig, joinPath, dirName, baseName } from './core/config.js';
+// FileSystem implementation
+export { NodeFileSystem, resolvePath } from './core/node-fs.js';
+// Frontmatter parser
+export { parseFrontmatter, parseOrganonFile, estimateTokens, countSectionEntries, extractSection, countTableRows, } from './core/frontmatter-parser.js';
+// Core functions
+export { validateFrontmatter } from './core/validate-frontmatter.js';
+export { generateFrontmatter, serializeFrontmatter } from './core/generate-frontmatter.js';
+export { query } from './core/query.js';
+export { health } from './core/health.js';
+export { find } from './core/find.js';
+export { verifyTriplets } from './core/verify-triplets.js';
+export { suggestTools } from './core/suggest-tools.js';
+export { verify, registerGate, getRegisteredGates } from './core/verify.js';
+// Invariant coverage
+export { computeInvariantCoverage, extractInvariants, scanTestAnnotations, computeCoverage } from './core/invariant-coverage.js';
+// Workflow validation
+export { validateWorkflow } from './core/validate-workflow.js';
+// Protocol parsing
+export { parseProtocols } from './core/add-protocols-array.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwCH,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG9E,4BAA4B;AAC5B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG3F,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAGxC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,qBAAqB;AACrB,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEjI,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/mcp/prompts.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Prompt registrations — 4 methodology workflow prompts.
+ *
+ * These encode the Organon methodology workflows so fresh agents
+ * can follow correct procedures without prior context.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/mcp/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/mcp/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0RvD"}

package/dist/mcp/prompts.js

@@ -0,0 +1,265 @@
+/**
+ * MCP Prompt registrations — 4 methodology workflow prompts.
+ *
+ * These encode the Organon methodology workflows so fresh agents
+ * can follow correct procedures without prior context.
+ */
+import { z } from 'zod';
+export function registerPrompts(server) {
+    // 1. implement-feature — Ethos-first feature development
+    server.prompt('implement-feature', 'Guide through ethos-first feature development: load context, create ETHOS.md, implement, verify', {
+        featureName: z.string().describe('Name of the feature to implement'),
+        domain: z.string().optional().describe('Target domain (if known)'),
+    }, (args) => {
+        const domain = args.domain ? `in the **${args.domain}** domain` : '';
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `# Implement Feature: ${args.featureName}
+
+Follow the Organon ethos-first development workflow ${domain}:
+
+## Step 1: Load Context
+1. Use \`organon_query\` with \`scope: "product"\` to load product-level constraints
+${args.domain ? `2. Use \`organon_query\` with \`scope: "domain"\` and \`name: "${args.domain}"\` to load domain constraints` : '2. Use `organon_find` to identify which domain this feature belongs to'}
+3. Use \`organon_query\` with \`task: "${args.featureName.toLowerCase().replace(/\s+/g, '_')}"\` to find relevant organons
+4. Check token budget — keep organon context under 15K tokens
+
+## Step 2: Create Feature ETHOS.md (if new)
+If this is a new feature, create its ETHOS.md first:
+1. Create \`organon/features/${args.featureName.toLowerCase().replace(/\s+/g, '-')}/ETHOS.md\`
+2. Include: Identity (IS/IS NOT), Invariants, Principles (prioritized), Decision Heuristics
+3. Use \`organon_generate_frontmatter\` to add proper frontmatter
+4. Use \`organon_validate_frontmatter\` to verify
+
+## Step 3: Implement
+1. Write code that satisfies the constraints from loaded organons
+2. Follow the priority order: invariants > principles (lower number wins)
+3. When uncertain, consult Decision Heuristics tables
+
+## Step 4: Verify
+1. Use \`organon_verify\` to run all verification gates
+2. Use \`organon_health\` to check overall system health
+3. Ensure no new violations were introduced
+
+## Step 5: Update Organons
+1. If implementation changes any constraints, update the affected ETHOS.md
+2. Use \`organon_validate_frontmatter\` to verify counts are still accurate
+3. Organon updates happen in the SAME PR as implementation (never deferred)`,
+                    },
+                }],
+        };
+    });
+    // 2. review-changes — Review against invariants
+    server.prompt('review-changes', 'Review code changes against organon constraints: load relevant organons, check invariant violations, run verification', {
+        scope: z.string().optional().describe('Limit review to this scope'),
+    }, (args) => {
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `# Review Changes Against Organon Constraints
+
+## Step 1: Identify Affected Organons
+1. Look at the files changed in this PR/commit
+2. Use \`organon_find\` with \`--file\` for each changed file to identify governing organons
+3. Load all identified organons${args.scope ? ` (filtered to scope: ${args.scope})` : ''}
+
+## Step 2: Check Invariant Compliance
+For each governing organon:
+1. Read the \`## Invariants\` section
+2. Verify that NONE of the changes violate any invariant
+3. If an invariant is violated, this is a blocking issue — changes must be revised
+
+## Step 3: Check Principle Alignment
+1. Read the \`## Principles\` section
+2. Verify changes align with principles (lower number = higher priority)
+3. If principles conflict, the lower-numbered principle wins
+
+## Step 4: Run Automated Verification
+1. Use \`organon_verify\` to run all verification gates
+2. Report any failures — these must be fixed before merge
+
+## Step 5: Check Organon Freshness
+1. Use \`organon_health\` to check if any affected organons are stale
+2. If organon and code have diverged, flag for review
+3. Ensure frontmatter counts are still accurate
+
+## Review Output Format
+Provide:
+- List of governing organons consulted
+- Invariant compliance: PASS / FAIL (with details)
+- Principle alignment: notes on any tensions
+- Verification gates: all PASS / specific failures
+- Recommendations: any organon updates needed`,
+                    },
+                }],
+        };
+    });
+    // 3. create-organon — Create new organon artifact
+    server.prompt('create-organon', 'Guide creation of a new organon artifact with correct structure and frontmatter', {
+        artifactType: z.enum(['ethos', 'philosophy', 'protocol']).describe('Type of artifact to create'),
+        scope: z.enum(['product', 'domain', 'feature', 'component', 'methodology']).describe('Scope level'),
+        name: z.string().describe('Name for the organon (kebab-case)'),
+    }, (args) => {
+        const structures = {
+            ethos: `## Identity
+
+### What ${args.name} IS
+- [Core identity statement]
+
+### What ${args.name} IS NOT
+- [Boundary statement]
+
+## Invariants
+
+1. **[Rule name].** [Rule description.]
+
+## Principles (Prioritized)
+
+1. **[Highest priority].** [Description.]
+
+## Decision Heuristics
+
+| Situation | Action |
+|-----------|--------|
+| When [X] | Do [Y] |`,
+            philosophy: `## The Problem
+
+[Describe the challenge this solves.]
+
+## The Bet
+
+[Core approach chosen.]
+
+## Design Decisions
+
+### 1. [Decision Name]
+[What and why.]
+**Rationale:** [Reasoning.]
+
+## Trade-offs
+
+| Decision | Benefit | Cost |
+|----------|---------|------|
+| [Choice] | [Gain] | [Sacrifice] |`,
+            protocol: `## Goal
+
+[What successful completion achieves.]
+
+## Preconditions
+
+Before starting, verify:
+- [ ] [Required condition]
+
+## Steps
+
+1. **[Step name].** [Action.]
+2. **[Step name].** [Action.]
+
+## Verification
+
+After completion, confirm:
+- [ ] [Observable outcome]`,
+        };
+        const typeMap = {
+            ethos: 'constraints',
+            philosophy: 'rationale',
+            protocol: 'procedures',
+        };
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `# Create ${args.artifactType.toUpperCase()}.md for "${args.name}"
+
+## Step 1: Check Parent Scope
+1. Use \`organon_find\` with \`scope: "product"\` to load product-level constraints
+2. This new organon must inherit from and never contradict parent constraints
+3. Add \`inherits_from\` in frontmatter referencing the parent
+
+## Step 2: Create File
+Create \`organon/${args.scope === 'domain' ? 'domains' : args.scope === 'feature' ? 'features' : args.scope + 's'}/${args.name}/${args.artifactType.toUpperCase()}.md\`
+
+## Step 3: Add Frontmatter
+\`\`\`yaml
+---
+type: ${typeMap[args.artifactType]}
+scope: ${args.scope}
+name: ${args.name}
+version: "1.0"
+summary: [One sentence, max 200 chars]
+token_estimate: [Will be calculated]
+inherits_from: [product]
+---
+\`\`\`
+
+## Step 4: Add Structure
+Use this template:
+
+${structures[args.artifactType]}
+
+## Step 5: Generate & Validate
+1. Use \`organon_generate_frontmatter\` to calculate counts and token_estimate
+2. Use \`organon_validate_frontmatter\` to verify the file passes all 4 stages
+3. Fix any issues before committing`,
+                    },
+                }],
+        };
+    });
+    // 4. evolve-organon — Modify existing constraints
+    server.prompt('evolve-organon', 'Guide organon evolution with RFC-awareness for constraint changes', {
+        organonPath: z.string().describe('Path to the organon file to evolve'),
+        changeType: z.enum(['add-invariant', 'modify-invariant', 'add-principle', 'update-counts', 'add-heuristic']).describe('Type of change'),
+    }, (args) => {
+        const needsRfc = ['add-invariant', 'modify-invariant', 'add-principle'].includes(args.changeType);
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `# Evolve Organon: ${args.organonPath}
+Change type: **${args.changeType}**
+
+${needsRfc ? `## RFC Required
+This change type (${args.changeType}) modifies constraints. Per the RFC-Driven Evolution pattern:
+- **New product-level invariants** require an RFC
+- **Constraint modifications** require an RFC
+- An RFC documents the rationale and impact
+
+### RFC Checklist
+1. Create an RFC document describing the change and rationale
+2. Include an "Organon Impact" section listing files to create/update/delete
+3. Get the RFC reviewed and accepted before proceeding
+
+` : '## Direct Edit Allowed\nThis change type does not require an RFC (it\'s a non-constraint update).\n\n'}## Step 1: Load Current State
+1. Read the current file at \`${args.organonPath}\`
+2. Use \`organon_validate_frontmatter\` with the file to check current validity
+3. Note current counts in frontmatter
+
+## Step 2: Make the Change
+Apply the ${args.changeType} change to the file content.
+
+## Step 3: Update Frontmatter
+1. Use \`organon_generate_frontmatter\` to recalculate counts and token_estimate
+2. Bump the version number (minor version for additions, patch for corrections)
+3. Update \`last_reviewed\` to today's date
+
+## Step 4: Verify
+1. Use \`organon_validate_frontmatter\` to verify the updated file
+2. Use \`organon_verify\` to check nothing is broken system-wide
+3. Check that child organons don't contradict the updated constraints
+
+## Step 5: Same-PR Principle
+Organon updates must be in the SAME commit/PR as any related code changes.
+Never defer organon updates to a follow-up PR.`,
+                    },
+                }],
+        };
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/mcp/prompts.js.map

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

package/dist/mcp/resources.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP Resource registrations — 4 resources exposing the organon hierarchy.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FileSystem, OrganonConfig } from '../core/types.js';
+export declare function registerResources(server: McpServer, projectRoot: string, config: OrganonConfig, fs: FileSystem): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/mcp/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMlE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,UAAU,GACb,IAAI,CAgIN"}

package/dist/mcp/resources.js

@@ -0,0 +1,111 @@
+/**
+ * MCP Resource registrations — 4 resources exposing the organon hierarchy.
+ */
+import { query } from '../core/query.js';
+import { health } from '../core/health.js';
+import { joinPath } from '../core/config.js';
+export function registerResources(server, projectRoot, config, fs) {
+    // 1. Index — all organon files with frontmatter summaries
+    server.resource('organon-index', 'organon://index', async (uri) => {
+        const result = await query({
+            projectRoot,
+            config,
+            fs,
+            verbose: false,
+        });
+        const index = result.files.map((f) => ({
+            path: f.path,
+            type: f.frontmatter?.type,
+            scope: f.frontmatter?.scope,
+            name: f.frontmatter?.name,
+            summary: f.frontmatter?.summary,
+            token_estimate: f.frontmatter?.token_estimate,
+            load_priority: f.frontmatter?.load_priority,
+        }));
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(index, null, 2),
+                }],
+        };
+    });
+    // 2. File — read individual organon file by path
+    server.resource('organon-file', 'organon://file/{path}', async (uri) => {
+        const filePath = uri.pathname.replace(/^\//, '');
+        const absPath = joinPath(projectRoot, filePath);
+        try {
+            const content = await fs.readFile(absPath);
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: 'text/markdown',
+                        text: content,
+                    }],
+            };
+        }
+        catch {
+            return {
+                contents: [{
+                        uri: uri.href,
+                        mimeType: 'text/plain',
+                        text: `Error: File not found: ${filePath}`,
+                    }],
+            };
+        }
+    });
+    // 3. Scope — all organons at a scope level
+    server.resource('organon-scope', 'organon://scope/{scope}', async (uri) => {
+        const scope = uri.pathname.replace(/^\//, '');
+        const result = await query({
+            projectRoot,
+            config,
+            fs,
+            scope,
+            verbose: false,
+        });
+        const scopeData = result.files.map((f) => ({
+            path: f.path,
+            type: f.frontmatter?.type,
+            name: f.frontmatter?.name,
+            summary: f.frontmatter?.summary,
+            token_estimate: f.frontmatter?.token_estimate,
+        }));
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(scopeData, null, 2),
+                }],
+        };
+    });
+    // 4. Health — quick health summary
+    server.resource('organon-health', 'organon://health', async (uri) => {
+        const result = await health({
+            projectRoot,
+            config,
+            fs,
+            fixSuggestions: true,
+        });
+        const summary = {
+            score: result.score,
+            coverage: result.coverage,
+            validation: result.validation,
+            tokens: result.tokens,
+            freshness: {
+                fresh: result.freshness.fresh,
+                stale: result.freshness.stale,
+                unknown: result.freshness.unknown,
+            },
+            topIssues: result.issues.slice(0, 10),
+        };
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(summary, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP Server — Organon methodology tools exposed via Model Context Protocol.
+ *
+ * Runs on stdio transport. Started via `organon mcp` command.
+ */
+export declare function startServer(projectRoot: string, configPath?: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map