@grafema/cli 0.3.24 → 0.3.27

package/dist/commands/export.js

@@ -0,0 +1,88 @@
+/**
+ * `grafema export` — emit a multi-format spec from the feature graph
+ * (REG-1116, REG-1118).
+ *
+ * Modes shipped:
+ *   --as openapi-3.1  → http:route features only
+ *   --as docs-md      → all FEATURE categories (single + bulk)
+ *
+ * Phase 2 formats (mcp-schema, asyncapi, json-schema, ts-declarations,
+ * mermaid) plug in by adding renderers to packages/util/src/exporters; the
+ * CLI surface here doesn't change.
+ */
+import { Command } from 'commander';
+import { resolve, join, dirname } from 'path';
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { RFDBServerBackend, RFDBClient, RENDERERS } from '@grafema/util';
+import { exitWithError } from '../utils/errorFormatter.js';
+import { runExport } from './exportAction.js';
+const KNOWN_FORMATS = Object.keys(RENDERERS).sort().join(', ');
+export const exportCommand = new Command('export')
+    .description('Export FEATURE entries from the graph in a chosen format')
+    .requiredOption('--feature <pattern>', "Feature glob (e.g. 'cli:*', 'http:*', \"cli:command:'analyze'\")")
+    .requiredOption('--as <format>', `Output format (${KNOWN_FORMATS})`)
+    .option('-o, --output <path>', 'Write output to <path> instead of stdout')
+    .option('-p, --project <path>', 'Project path', '.')
+    .addHelpText('after', `
+Examples:
+  grafema export --feature 'http:*' --as openapi-3.1 --output api.yaml
+  grafema export --feature 'cli:*' --as docs-md
+  grafema export --feature "cli:command:'analyze'" --as docs-md
+
+Phase 1 supports two formats: openapi-3.1 (http:route only) and
+docs-md (all categories). Other formats — mcp-schema, asyncapi,
+json-schema, ts-declarations, mermaid — are tracked separately.
+`)
+    .action(async (options) => {
+    if (!options.feature || !options.as) {
+        exitWithError('Both --feature and --as are required', [
+            'See: grafema export --help',
+        ]);
+    }
+    const projectPath = resolve(options.project);
+    const grafemaDir = join(projectPath, '.grafema');
+    const dbPath = join(grafemaDir, 'graph.rfdb');
+    if (!existsSync(dbPath)) {
+        exitWithError('No graph database found', ['Run: grafema analyze']);
+    }
+    // RFDBServerBackend negotiates protocol v3, which returns semantic edge
+    // dst values that don't resolve via getNode(). Connect with a plain
+    // RFDBClient (protocol v2) so edges preserve raw numeric ids end-to-end.
+    // Still use RFDBServerBackend for its auto-start side effect.
+    const server = new RFDBServerBackend({ dbPath, clientName: 'cli-bootstrap' });
+    await server.connect();
+    const socketPath = server.socketPath;
+    const rawClient = new RFDBClient(socketPath, 'export');
+    await rawClient.connect();
+    try {
+        await runExport({
+            feature: options.feature,
+            as: options.as,
+            output: options.output,
+        }, {
+            backend: rawClient,
+            writeText: writeOutput,
+            warn: (msg) => console.error(msg),
+            fail: (msg, code) => {
+                console.error(`✗ ${msg}`);
+                process.exit(code);
+            },
+        });
+    }
+    finally {
+        rawClient.close();
+        await server.close();
+    }
+});
+/** Default writer: stdout when path == null, otherwise file. */
+function writeOutput(path, text) {
+    if (path === null) {
+        process.stdout.write(text);
+        return;
+    }
+    const dir = dirname(path);
+    if (dir && !existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, text, 'utf8');
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

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

package/dist/commands/exportAction.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `grafema export` action (REG-1116, REG-1118).
+ *
+ * Pure orchestration logic — connects feature glob → renderer, with all I/O
+ * surfaced as inputs (backend) and effects (writeText / log / exit). The
+ * Commander shell in `export.ts` plugs in concrete implementations; tests
+ * supply mocks.
+ */
+import { type ExportBackendLike, type Renderer } from '@grafema/util';
+export interface ExportActionOptions {
+    /** Feature glob — required. */
+    feature: string;
+    /** Output format — required. Must be a key of RENDERERS. */
+    as: string;
+    /** Optional output file path. When unset, stdout. */
+    output?: string;
+}
+export interface ExportActionDeps {
+    backend: ExportBackendLike;
+    /** Write file/stdout content. Receives `null` for path → stdout. */
+    writeText: (path: string | null, text: string) => Promise<void> | void;
+    /** Print to stderr (for diagnostic notes that should not contaminate stdout). */
+    warn: (msg: string) => void;
+    /** Reported when an unrecoverable error happens — caller decides exit code. */
+    fail: (msg: string, code: number) => never;
+    /** Renderers map — defaults to the package-shipped RENDERERS. */
+    renderers?: Record<string, Renderer>;
+}
+/**
+ * Run the export action. Returns the rendered text on success — convenient
+ * for tests that don't want to mock writeText. The deps' writeText is also
+ * invoked so production callers don't need to handle the return value.
+ */
+export declare function runExport(options: ExportActionOptions, deps: ExportActionDeps): Promise<string>;
+//# sourceMappingURL=exportAction.d.ts.map

package/dist/commands/exportAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportAction.d.ts","sourceRoot":"","sources":["../../src/commands/exportAction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAKL,KAAK,iBAAiB,EAEtB,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,oEAAoE;IACpE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvE,iFAAiF;IACjF,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;IAC3C,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,CA2DjB"}

package/dist/commands/exportAction.js

@@ -0,0 +1,58 @@
+/**
+ * `grafema export` action (REG-1116, REG-1118).
+ *
+ * Pure orchestration logic — connects feature glob → renderer, with all I/O
+ * surfaced as inputs (backend) and effects (writeText / log / exit). The
+ * Commander shell in `export.ts` plugs in concrete implementations; tests
+ * supply mocks.
+ */
+import { collectFeatureSnapshots, parseFeaturePattern, resolveCategories, RENDERERS, } from '@grafema/util';
+/**
+ * Run the export action. Returns the rendered text on success — convenient
+ * for tests that don't want to mock writeText. The deps' writeText is also
+ * invoked so production callers don't need to handle the return value.
+ */
+export async function runExport(options, deps) {
+    const renderers = deps.renderers ?? RENDERERS;
+    const renderer = renderers[options.as];
+    if (!renderer) {
+        const known = Object.keys(renderers).sort().join(', ');
+        deps.fail(`Unknown format '${options.as}'. Known formats: ${known}.`, 2);
+    }
+    const parsed = parseFeaturePattern(options.feature);
+    if (!parsed) {
+        deps.fail(`Invalid --feature pattern: '${options.feature}'.`, 2);
+    }
+    // Validate format-category compatibility before doing any graph work.
+    const categories = resolveCategories(parsed.categoryGlob);
+    if (categories.length === 0) {
+        deps.fail(`Feature pattern '${options.feature}' matches no known category.`, 2);
+    }
+    const unsupported = categories.filter(c => !renderer.supports(c));
+    if (unsupported.length > 0 && unsupported.length === categories.length) {
+        deps.fail(`Format '${options.as}' does not support category '${unsupported[0]}'. ` +
+            `Try '--as docs-md' or narrow the pattern.`, 2);
+    }
+    const snapshots = await collectFeatureSnapshots(deps.backend, options.feature);
+    // If the renderer rejects some categories, drop those snapshots before
+    // rendering. Warn so the user sees the gap.
+    const accepted = [];
+    let droppedForCategory = 0;
+    for (const s of snapshots) {
+        if (renderer.supports(s.category))
+            accepted.push(s);
+        else
+            droppedForCategory++;
+    }
+    if (droppedForCategory > 0) {
+        deps.warn(`Skipping ${droppedForCategory} feature${droppedForCategory === 1 ? '' : 's'} ` +
+            `unsupported by --as ${options.as}.`);
+    }
+    if (accepted.length === 0) {
+        deps.warn(`No features matched '${options.feature}' for format '${options.as}'.`);
+    }
+    const text = renderer.render(accepted);
+    await deps.writeText(options.output ?? null, text);
+    return text;
+}
+//# sourceMappingURL=exportAction.js.map

package/dist/commands/exportAction.js.map

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

package/dist/commands/features.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `grafema features` — surface FEATURE-level cross-modality insights.
+ *
+ * Currently exposes one mode:
+ *   --duplicates   List clusters of FEATUREs whose entry-points share an
+ *                  identical BEHAVIOR (same forward-slice hash).
+ *
+ * Other modes (--by-effect, --by-domain, …) are anticipated but not in scope
+ * for REG-1119.
+ */
+import { Command } from 'commander';
+export declare const featuresCommand: Command;
+//# sourceMappingURL=features.d.ts.map

package/dist/commands/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/commands/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,eAAO,MAAM,eAAe,SAkDxB,CAAC"}

package/dist/commands/features.js

@@ -0,0 +1,69 @@
+/**
+ * `grafema features` — surface FEATURE-level cross-modality insights.
+ *
+ * Currently exposes one mode:
+ *   --duplicates   List clusters of FEATUREs whose entry-points share an
+ *                  identical BEHAVIOR (same forward-slice hash).
+ *
+ * Other modes (--by-effect, --by-domain, …) are anticipated but not in scope
+ * for REG-1119.
+ */
+import { Command } from 'commander';
+import { resolve, join } from 'path';
+import { existsSync } from 'fs';
+import { RFDBServerBackend } from '@grafema/util';
+import { exitWithError } from '../utils/errorFormatter.js';
+import { findSharedBehaviorClusters, formatSharedBehaviorClusters, } from './featuresAction.js';
+export const featuresCommand = new Command('features')
+    .description('List FEATURE-level cross-modality insights (e.g. duplicate behaviors)')
+    .option('-p, --project <path>', 'Project path', '.')
+    .option('-j, --json', 'Output as JSON')
+    .option('-d, --duplicates', 'List clusters of FEATUREs that share a BEHAVIOR')
+    .option('--min-cluster-size <n>', 'Minimum features per cluster (default: 2)', '2')
+    .option('--limit <n>', 'Maximum clusters to return (default: 100)', '100')
+    .addHelpText('after', `
+Examples:
+  grafema features --duplicates             List FEATUREs with shared behaviors
+  grafema features --duplicates --json      Same, machine-readable JSON
+  grafema features -d --min-cluster-size 3  Only clusters with >=3 features
+`)
+    .action(async (options) => {
+    if (!options.duplicates) {
+        exitWithError('No subcommand selected', [
+            'Try: grafema features --duplicates',
+            'See: grafema features --help',
+        ]);
+    }
+    const projectPath = resolve(options.project);
+    const grafemaDir = join(projectPath, '.grafema');
+    const dbPath = join(grafemaDir, 'graph.rfdb');
+    if (!existsSync(dbPath)) {
+        exitWithError('No graph database found', ['Run: grafema analyze']);
+    }
+    const minClusterSize = parsePositiveInt(options.minClusterSize, 2);
+    const limit = parsePositiveInt(options.limit, 100);
+    const backend = new RFDBServerBackend({ dbPath, clientName: 'cli' });
+    await backend.connect();
+    try {
+        // RFDBServerBackend matches FeaturesBackendLike at runtime.
+        const clusters = await findSharedBehaviorClusters(backend, { minClusterSize, limit });
+        if (options.json) {
+            console.log(JSON.stringify(clusters, null, 2));
+        }
+        else {
+            console.log(formatSharedBehaviorClusters(clusters));
+        }
+    }
+    finally {
+        await backend.close();
+    }
+});
+function parsePositiveInt(raw, fallback) {
+    if (!raw)
+        return fallback;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return n;
+}
+//# sourceMappingURL=features.js.map

package/dist/commands/features.js.map

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

package/dist/commands/featuresAction.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Features command action — surface FEATURE-level cross-modality insights.
+ *
+ * Currently implements --duplicates: groups BEHAVIOR nodes by their
+ * `metadata.hash` and lists every cluster of size >= 2. Each cluster shows the
+ * feature ENTRY_POINTs (incoming `IMPLEMENTED_BY` edges) that share the
+ * implementation.
+ *
+ * Surfaces the data emitted by `behaviorEnricher` Pass 2: SHARES_BEHAVIOR_WITH
+ * edges already exist, but they're not user-facing. This subcommand makes the
+ * insight visible from the CLI ("this CLI command and that MCP tool are thin
+ * wrappers around the same library function").
+ *
+ * REG-1119.
+ */
+import type { EdgeType } from '@grafema/types';
+/**
+ * Minimal backend interface — matches the subset of RFDBServerBackend
+ * (and the graph-handlers' GraphBackendLike) that we need. Lets us test with
+ * a simple in-memory mock without requiring a live RFDB server.
+ */
+export interface FeaturesBackendLike {
+    queryNodes(query: {
+        type?: string;
+        nodeType?: string;
+    }): AsyncIterable<Record<string, unknown>>;
+    getNode(id: string): Promise<Record<string, unknown> | null>;
+    getIncomingEdges(nodeId: string, edgeTypes?: EdgeType[] | null): Promise<Array<{
+        src: string;
+        dst: string;
+        type: string;
+        metadata?: Record<string, unknown> | undefined;
+    }>>;
+}
+/** A FEATURE participating in a shared-behavior cluster. */
+export interface SharedFeatureRef {
+    /** Feature semantic id. */
+    id: string;
+    /** Feature node type — e.g. `cli:command`, `mcp:tool`, `vscode:command`. */
+    type: string;
+    /** Feature name (e.g. `analyze`). */
+    name: string;
+    /** Source file (may be empty for synthetic features). */
+    file: string;
+}
+/** A group of FEATUREs whose behavior hashes are identical. */
+export interface SharedBehaviorCluster {
+    /** sha256 hash from BEHAVIOR.metadata.hash — the cluster key. */
+    hash: string;
+    /** Effects array carried on the shared BEHAVIOR. */
+    effects: string[];
+    /** Forward-slice size of the shared behavior. */
+    coreNodeCount: number;
+    /** Features that implement the same behavior. */
+    features: SharedFeatureRef[];
+}
+export interface FindSharedBehaviorOptions {
+    /** Minimum cluster size to include. Default 2. */
+    minClusterSize?: number;
+    /** Maximum number of clusters to return. Default 100. */
+    limit?: number;
+}
+/**
+ * Core algorithm — testable, accepts any backend implementing
+ * `FeaturesBackendLike`.
+ *
+ * Steps:
+ * 1. Iterate every BEHAVIOR node, read its `hash` + `effects` + `coreNodeCount`.
+ * 2. Bucket behaviors by hash.
+ * 3. For each bucket of size >= minClusterSize, walk incoming `IMPLEMENTED_BY`
+ *    edges to enumerate the FEATUREs.
+ *
+ * Returns clusters sorted by size (desc), then by hash (asc, deterministic).
+ */
+export declare function findSharedBehaviorClusters(backend: FeaturesBackendLike, options?: FindSharedBehaviorOptions): Promise<SharedBehaviorCluster[]>;
+/**
+ * Format clusters as a human-readable text report. Mirrors the symmetric MCP
+ * handler output: same field ordering, same labels. JSON output is the same
+ * structured array.
+ */
+export declare function formatSharedBehaviorClusters(clusters: SharedBehaviorCluster[]): string;
+//# sourceMappingURL=featuresAction.d.ts.map

package/dist/commands/featuresAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featuresAction.d.ts","sourceRoot":"","sources":["../../src/commands/featuresAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7D,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,GAC5B,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC,CAAC;CAC/G;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAiFlC;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAsBtF"}

package/dist/commands/featuresAction.js

@@ -0,0 +1,139 @@
+const DEFAULT_MIN_CLUSTER_SIZE = 2;
+const DEFAULT_LIMIT = 100;
+/**
+ * Core algorithm — testable, accepts any backend implementing
+ * `FeaturesBackendLike`.
+ *
+ * Steps:
+ * 1. Iterate every BEHAVIOR node, read its `hash` + `effects` + `coreNodeCount`.
+ * 2. Bucket behaviors by hash.
+ * 3. For each bucket of size >= minClusterSize, walk incoming `IMPLEMENTED_BY`
+ *    edges to enumerate the FEATUREs.
+ *
+ * Returns clusters sorted by size (desc), then by hash (asc, deterministic).
+ */
+export async function findSharedBehaviorClusters(backend, options = {}) {
+    const minClusterSize = Math.max(2, options.minClusterSize ?? DEFAULT_MIN_CLUSTER_SIZE);
+    const limit = Math.max(1, options.limit ?? DEFAULT_LIMIT);
+    const behaviors = [];
+    for await (const node of backend.queryNodes({ type: 'BEHAVIOR' })) {
+        const id = String(node.id ?? '');
+        if (!id)
+            continue;
+        const hash = readString(node.hash);
+        if (!hash)
+            continue;
+        const effects = readStringArray(node.effects);
+        const coreNodeCount = readNumber(node.coreNodeCount) ?? 0;
+        behaviors.push({ id, hash, effects, coreNodeCount });
+    }
+    // 2. Group by hash.
+    const byHash = new Map();
+    for (const b of behaviors) {
+        let bucket = byHash.get(b.hash);
+        if (!bucket) {
+            bucket = [];
+            byHash.set(b.hash, bucket);
+        }
+        bucket.push(b);
+    }
+    // 3. For each multi-behavior bucket, expand incoming IMPLEMENTED_BY edges
+    //    into FEATURE refs.
+    const clusters = [];
+    for (const [hash, bucket] of byHash) {
+        if (bucket.length < minClusterSize)
+            continue;
+        const features = [];
+        const seenFeatureIds = new Set();
+        for (const beh of bucket) {
+            const edges = await backend.getIncomingEdges(beh.id, ['IMPLEMENTED_BY']);
+            for (const edge of edges) {
+                const featureId = String(edge.src);
+                if (!featureId || seenFeatureIds.has(featureId))
+                    continue;
+                seenFeatureIds.add(featureId);
+                const node = await backend.getNode(featureId);
+                if (!node)
+                    continue;
+                features.push({
+                    id: featureId,
+                    type: readString(node.type) ?? 'UNKNOWN',
+                    name: readString(node.name) ?? '',
+                    file: readString(node.file) ?? '',
+                });
+            }
+        }
+        // De-dup may have dropped behaviors back below threshold (e.g. multiple
+        // BEHAVIOR rows from the same FEATURE). Re-check on the resolved feature
+        // count.
+        if (features.length < minClusterSize)
+            continue;
+        // Stable order of features within a cluster: by type then name.
+        features.sort((a, b) => (a.type === b.type ? a.name.localeCompare(b.name) : a.type.localeCompare(b.type)));
+        // Take effects + coreNodeCount from the first behavior — they're identical
+        // for behaviors with the same hash by construction.
+        clusters.push({
+            hash,
+            effects: bucket[0].effects,
+            coreNodeCount: bucket[0].coreNodeCount,
+            features,
+        });
+    }
+    // Sort clusters: largest first, hash ascending for tie-break (deterministic).
+    clusters.sort((a, b) => (b.features.length - a.features.length) || a.hash.localeCompare(b.hash));
+    return clusters.slice(0, limit);
+}
+/**
+ * Format clusters as a human-readable text report. Mirrors the symmetric MCP
+ * handler output: same field ordering, same labels. JSON output is the same
+ * structured array.
+ */
+export function formatSharedBehaviorClusters(clusters) {
+    if (clusters.length === 0) {
+        return 'No FEATUREs share a BEHAVIOR (each entry-point has a unique implementation).';
+    }
+    const lines = [];
+    lines.push(`Shared-behavior clusters: ${clusters.length}`);
+    lines.push('='.repeat(40));
+    for (let i = 0; i < clusters.length; i++) {
+        const c = clusters[i];
+        lines.push('');
+        lines.push(`Cluster ${i + 1} — ${c.features.length} feature(s) share behavior`);
+        lines.push(`  hash:          ${c.hash.slice(0, 16)}…`);
+        lines.push(`  coreNodeCount: ${c.coreNodeCount}`);
+        lines.push(`  effects:       ${c.effects.length === 0 ? '(none)' : c.effects.join(', ')}`);
+        lines.push('  features:');
+        for (const f of c.features) {
+            const file = f.file ? ` [${f.file}]` : '';
+            lines.push(`    - ${f.type}  ${f.name}${file}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Internal helpers — defensive parsers tolerating both string-encoded JSON
+// metadata (from raw client) and already-parsed values (from RFDBServerBackend
+// _parseNode).
+// ---------------------------------------------------------------------------
+function readString(v) {
+    return typeof v === 'string' ? v : undefined;
+}
+function readNumber(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : undefined;
+}
+function readStringArray(v) {
+    if (Array.isArray(v))
+        return v.filter((x) => typeof x === 'string');
+    if (typeof v === 'string') {
+        try {
+            const parsed = JSON.parse(v);
+            if (Array.isArray(parsed))
+                return parsed.filter((x) => typeof x === 'string');
+        }
+        catch {
+            // not JSON
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=featuresAction.js.map

package/dist/commands/featuresAction.js.map

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

package/dist/commands/start.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `grafema start` — unified command to bring up the entire Grafema stack.
+ *
+ * Starts RFDB server (with HTTP) and prints connection info.
+ * Foreground by default; `--background` detaches.
+ *
+ * `grafema stop` — graceful shutdown of everything.
+ */
+import { Command } from 'commander';
+export declare const startCommand: Command;
+export declare const stopCommand: Command;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0FpC,eAAO,MAAM,YAAY,SAgKrB,CAAC;AAIL,eAAO,MAAM,WAAW,SAuCpB,CAAC"}