flowscript-core 1.0.0

package/dist/cli.js

@@ -0,0 +1,463 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * FlowScript CLI
+ *
+ * Command-line interface for FlowScript toolchain:
+ * - parse: Compile FlowScript text → IR JSON
+ * - lint: Validate FlowScript semantics
+ * - validate: Verify IR JSON against schema
+ * - query: Query IR for cognitive insights (5 queries)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const parser_1 = require("./parser");
+const linter_1 = require("./linter");
+const validate_1 = require("./validate");
+const query_engine_1 = require("./query-engine");
+const serializer_1 = require("./serializer");
+const program = new commander_1.Command();
+program
+    .name('flowscript')
+    .description('FlowScript toolchain - parser, linter, and validator for cognitive graphs')
+    .version('1.0.0');
+/**
+ * Parse command: FlowScript text → IR JSON
+ */
+program
+    .command('parse')
+    .description('Parse FlowScript text and emit IR JSON')
+    .argument('<file>', 'FlowScript file to parse (.fs)')
+    .option('-o, --output <file>', 'Output file for IR JSON (default: stdout)')
+    .option('-c, --compact', 'Compact JSON output (no formatting)')
+    .action((file, options) => {
+    try {
+        // Read input file
+        if (!fs.existsSync(file)) {
+            console.error(`Error: File not found: ${file}`);
+            process.exit(1);
+        }
+        const input = fs.readFileSync(file, 'utf-8');
+        // Parse
+        const parser = new parser_1.Parser(file);
+        const ir = parser.parse(input);
+        // Format output
+        const json = options.compact
+            ? JSON.stringify(ir)
+            : JSON.stringify(ir, null, 2);
+        // Write output
+        if (options.output) {
+            fs.writeFileSync(options.output, json, 'utf-8');
+            console.log(`✓ Parsed ${file} → ${options.output}`);
+        }
+        else {
+            console.log(json);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Parse error: ${error.message}`);
+        }
+        else {
+            console.error('Parse error:', error);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Serialize command: IR JSON → FlowScript text
+ */
+program
+    .command('serialize')
+    .description('Convert IR JSON back to FlowScript text')
+    .argument('<file>', 'IR JSON file to serialize (.json)')
+    .option('-o, --output <file>', 'Output file for FlowScript text (default: stdout)')
+    .action((file, options) => {
+    try {
+        const ir = loadIR(file);
+        const output = (0, serializer_1.serialize)(ir);
+        if (options.output) {
+            fs.writeFileSync(options.output, output, 'utf-8');
+            console.log(`✓ Serialized ${file} → ${options.output}`);
+        }
+        else {
+            process.stdout.write(output);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Serialize error: ${error.message}`);
+        }
+        else {
+            console.error('Serialize error:', error);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Lint command: Validate FlowScript semantics
+ */
+program
+    .command('lint')
+    .description('Lint FlowScript for semantic errors and warnings')
+    .argument('<file>', 'FlowScript file to lint (.fs)')
+    .option('-j, --json', 'Output results as JSON')
+    .action((file, options) => {
+    try {
+        // Read and parse input file
+        if (!fs.existsSync(file)) {
+            console.error(`Error: File not found: ${file}`);
+            process.exit(1);
+        }
+        const input = fs.readFileSync(file, 'utf-8');
+        const parser = new parser_1.Parser(file);
+        const ir = parser.parse(input);
+        // Run linter
+        const linter = new linter_1.Linter();
+        const results = linter.lint(ir);
+        // Get counts
+        const errors = linter.getErrors(results);
+        const warnings = linter.getWarnings(results);
+        // Output results
+        if (options.json) {
+            console.log(JSON.stringify({
+                file,
+                errors: errors.length,
+                warnings: warnings.length,
+                results
+            }, null, 2));
+        }
+        else {
+            // Human-readable output
+            if (results.length === 0) {
+                console.log(`✓ ${file}: No issues found`);
+            }
+            else {
+                console.log(`\nLinting ${file}:\n`);
+                for (const result of results) {
+                    const prefix = result.severity === 'ERROR' ? '✗' : '⚠';
+                    const location = result.location
+                        ? `${result.location.file}:${result.location.line}`
+                        : file;
+                    console.log(`${prefix} ${result.rule}: ${result.message}`);
+                    console.log(`  at ${location}`);
+                    if (result.suggestion) {
+                        console.log(`  Suggestion: ${result.suggestion}`);
+                    }
+                    console.log('');
+                }
+                console.log(`${errors.length} error(s), ${warnings.length} warning(s)`);
+            }
+        }
+        // Exit code: 0 if no errors, 1 if errors found (warnings OK)
+        process.exit(errors.length > 0 ? 1 : 0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Lint error: ${error.message}`);
+        }
+        else {
+            console.error('Lint error:', error);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Validate command: Verify IR JSON against schema
+ */
+program
+    .command('validate')
+    .description('Validate IR JSON against canonical schema')
+    .argument('<file>', 'IR JSON file to validate (.json)')
+    .option('-v, --verbose', 'Show detailed validation errors')
+    .action((file, options) => {
+    try {
+        // Read IR JSON file
+        if (!fs.existsSync(file)) {
+            console.error(`Error: File not found: ${file}`);
+            process.exit(1);
+        }
+        const json = fs.readFileSync(file, 'utf-8');
+        const ir = JSON.parse(json);
+        // Validate against schema
+        const result = (0, validate_1.validateIR)(ir);
+        if (result.valid) {
+            console.log(`✓ ${file}: Valid IR`);
+            process.exit(0);
+        }
+        else {
+            console.log(`✗ ${file}: Invalid IR`);
+            console.log(`  ${result.errors.length} validation error(s)\n`);
+            if (options.verbose) {
+                for (const error of result.errors) {
+                    console.log(`  - ${error.instancePath || '/'}: ${error.message}`);
+                    if (error.params) {
+                        console.log(`    Params: ${JSON.stringify(error.params)}`);
+                    }
+                }
+            }
+            else {
+                console.log('  Use --verbose to see detailed errors');
+            }
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Validation error: ${error.message}`);
+        }
+        else {
+            console.error('Validation error:', error);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Helper: Load IR from file
+ */
+function loadIR(file) {
+    if (!fs.existsSync(file)) {
+        console.error(`Error: File not found: ${file}`);
+        process.exit(1);
+    }
+    const json = fs.readFileSync(file, 'utf-8');
+    try {
+        return JSON.parse(json);
+    }
+    catch (error) {
+        console.error(`Error: Invalid JSON in ${file}`);
+        process.exit(1);
+    }
+}
+/**
+ * Query command group: Query FlowScript IR for insights
+ */
+const query = program
+    .command('query')
+    .description('Query FlowScript IR for cognitive insights');
+/**
+ * Query: why - Trace causal ancestry
+ */
+query
+    .command('why')
+    .description('Trace causal ancestry backward from a node')
+    .argument('<node-id>', 'Node ID to query')
+    .argument('<ir-file>', 'IR JSON file')
+    .option('-f, --format <format>', 'Output format: chain|tree|minimal', 'chain')
+    .option('-d, --max-depth <depth>', 'Maximum depth to traverse', parseInt)
+    .addHelpText('after', `
+Examples:
+  $ flowscript query why decision-001 examples/decision.json
+  $ flowscript query why node-123 output.json --format=tree
+  $ flowscript query why node-456 output.json --max-depth=3`)
+    .action((nodeId, irFile, options) => {
+    try {
+        const ir = loadIR(irFile);
+        const engine = new query_engine_1.FlowScriptQueryEngine();
+        engine.load(ir);
+        const result = engine.why(nodeId, {
+            format: options.format,
+            maxDepth: options.maxDepth
+        });
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Query error: ${error.message}`);
+        }
+        else {
+            console.error('Query error:', error);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Query: what-if - Calculate impact analysis
+ */
+query
+    .command('what-if')
+    .description('Calculate forward impact analysis from a node')
+    .argument('<node-id>', 'Node ID to query')
+    .argument('<ir-file>', 'IR JSON file')
+    .option('-f, --format <format>', 'Output format: tree|list|summary', 'tree')
+    .option('-d, --max-depth <depth>', 'Maximum depth to traverse', parseInt)
+    .addHelpText('after', `
+Examples:
+  $ flowscript query what-if decision-001 examples/decision.json
+  $ flowscript query what-if node-123 output.json --format=summary
+  $ flowscript query what-if node-456 output.json --max-depth=2`)
+    .action((nodeId, irFile, options) => {
+    try {
+        const ir = loadIR(irFile);
+        const engine = new query_engine_1.FlowScriptQueryEngine();
+        engine.load(ir);
+        const result = engine.whatIf(nodeId, {
+            format: options.format,
+            maxDepth: options.maxDepth
+        });
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Query error: ${error.message}`);
+        }
+        else {
+            console.error('Query error:', error);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Query: tensions - Extract all tradeoffs
+ */
+query
+    .command('tensions')
+    .description('Extract and group all tension/tradeoff nodes')
+    .argument('<ir-file>', 'IR JSON file')
+    .option('-g, --group-by <grouping>', 'Grouping: axis|node|none', 'axis')
+    .option('-a, --axis <axis>', 'Filter by specific axis')
+    .option('-c, --with-context', 'Include parent context')
+    .addHelpText('after', `
+Examples:
+  $ flowscript query tensions examples/decision.json
+  $ flowscript query tensions output.json --group-by=node
+  $ flowscript query tensions output.json --axis="speed vs quality"
+  $ flowscript query tensions output.json --with-context`)
+    .action((irFile, options) => {
+    try {
+        const ir = loadIR(irFile);
+        const engine = new query_engine_1.FlowScriptQueryEngine();
+        engine.load(ir);
+        const result = engine.tensions({
+            groupBy: options.groupBy,
+            filterByAxis: options.axis ? [options.axis] : undefined,
+            includeContext: options.withContext
+        });
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Query error: ${error.message}`);
+        }
+        else {
+            console.error('Query error:', error);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Query: blocked - Find blocked tasks with impact analysis
+ */
+query
+    .command('blocked')
+    .description('Find all blocked nodes with dependency chains and impact scoring')
+    .argument('<ir-file>', 'IR JSON file')
+    .option('-s, --since <date>', 'Filter by blocked since date (YYYY-MM-DD)')
+    .option('-f, --format <format>', 'Output format: detailed|summary', 'detailed')
+    .addHelpText('after', `
+Examples:
+  $ flowscript query blocked examples/decision.json
+  $ flowscript query blocked output.json --since=2025-10-01
+  $ flowscript query blocked output.json --format=summary`)
+    .action((irFile, options) => {
+    try {
+        const ir = loadIR(irFile);
+        const engine = new query_engine_1.FlowScriptQueryEngine();
+        engine.load(ir);
+        const result = engine.blocked({
+            since: options.since,
+            format: options.format
+        });
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Query error: ${error.message}`);
+        }
+        else {
+            console.error('Query error:', error);
+        }
+        process.exit(1);
+    }
+});
+/**
+ * Query: alternatives - Reconstruct decision from alternatives
+ */
+query
+    .command('alternatives')
+    .description('Reconstruct decision rationale from alternative nodes')
+    .argument('<question-id>', 'Question node ID to analyze')
+    .argument('<ir-file>', 'IR JSON file')
+    .option('-f, --format <format>', 'Output format: comparison|simple', 'comparison')
+    .addHelpText('after', `
+Examples:
+  $ flowscript query alternatives question-001 examples/decision.json
+  $ flowscript query alternatives node-123 output.json --format=simple`)
+    .action((questionId, irFile, options) => {
+    try {
+        const ir = loadIR(irFile);
+        const engine = new query_engine_1.FlowScriptQueryEngine();
+        engine.load(ir);
+        const result = engine.alternatives(questionId, {
+            format: options.format
+        });
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Query error: ${error.message}`);
+        }
+        else {
+            console.error('Query error:', error);
+        }
+        process.exit(1);
+    }
+});
+// Parse arguments and run
+program.parse(process.argv);
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/errors/indentation-error.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Custom error class for indentation-related errors
+ *
+ * Thrown when indentation rules are violated (tabs, inconsistent spacing, etc.)
+ * Includes line number for helpful error messages
+ */
+export declare class IndentationError extends Error {
+    readonly lineNumber: number;
+    constructor(message: string, lineNumber: number);
+}
+//# sourceMappingURL=indentation-error.d.ts.map

package/dist/errors/indentation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indentation-error.d.ts","sourceRoot":"","sources":["../../src/errors/indentation-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAUhD"}

package/dist/errors/indentation-error.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndentationError = void 0;
+/**
+ * Custom error class for indentation-related errors
+ *
+ * Thrown when indentation rules are violated (tabs, inconsistent spacing, etc.)
+ * Includes line number for helpful error messages
+ */
+class IndentationError extends Error {
+    constructor(message, lineNumber) {
+        super(`${message} (Line ${lineNumber})`);
+        this.name = 'IndentationError';
+        this.lineNumber = lineNumber;
+        // Maintains proper stack trace for where error was thrown (V8 engines)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, IndentationError);
+        }
+    }
+}
+exports.IndentationError = IndentationError;
+//# sourceMappingURL=indentation-error.js.map

package/dist/errors/indentation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indentation-error.js","sourceRoot":"","sources":["../../src/errors/indentation-error.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAGzC,YAAY,OAAe,EAAE,UAAkB;QAC7C,KAAK,CAAC,GAAG,OAAO,UAAU,UAAU,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,uEAAuE;QACvE,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAbD,4CAaC"}

package/dist/grammar.ohm

@@ -0,0 +1,132 @@
+FlowScript {
+  // Document Structure
+  Document = Line*
+  Line = BlankLine | RelationshipExpression | Element
+
+  Element = Modifier* Content
+  Content = State | Insight | Question | Completion | Alternative | Block | Statement
+
+  BlankLine = space* "\n"
+  Statement = ~Modifier (~("\n" | "{" | "}") any)+ "\n"?
+
+  // Blocks (thought blocks / atomic processing units)
+  Block = "{" ws BlockContent? ws "}"
+  BlockContent = BlockLine (separator? BlockLine)* separator?
+  BlockLine = ws (ContinuationRel | RelationshipExpression | BlockElement)
+  BlockElement = Modifier* BlockContent_inner
+  BlockContent_inner = State | Insight | Question | Completion | Alternative | Block | BlockStatement
+  BlockStatement = ~Modifier (~("\n" | "{" | "}" | ";") any)+
+  separator = (space | "\n" | ";")+
+  ws = (space | "\n")*
+
+  // Relationship Expressions (must come before Statement in Line)
+  RelationshipExpression = RelNode RelOpNodePair+
+  RelOpNodePair = RelOp RelNode
+  RelNode = space* (Block | TypedRelTarget | NodeText) space*
+
+  // Typed targets in relationship expressions — like Insight/Question/Completion/Alternative
+  // but without RelOpNodePair* chaining (outer expression handles that)
+  TypedRelTarget = ThoughtTarget | ActionTarget | QuestionTarget | CompletionTarget | AlternativeTarget
+  ThoughtTarget = "thought:" space* thoughtText? Block?
+  ActionTarget = "action:" space* actionText? Block?
+  QuestionTarget = "?" space* questionText? Block?
+  CompletionTarget = "✓" space* completionText? Block?
+  AlternativeTarget = "||" space* alternativeText? Block?
+
+  // Continuation Relationship (only valid inside blocks)
+  ContinuationRel = RelOp space* RelNode
+
+  NodeText = ~insightPrefix ~"?" ~"✓" ~"||" (~("<->" | "->" | "<-" | "=>" | "><[" | "><" | "\n" | "{" | "}" | ";") any)+
+  insightPrefix = "thought:" | "action:"
+
+  RelOp = bidirectional | reverseCausal | causal | temporal | tensionWithAxis | tensionWithoutAxis
+
+  bidirectional = "<->"
+  reverseCausal = "<-"
+  causal = "->"
+  temporal = "=>"
+  tensionWithAxis = "><[" axisLabel "]"
+  tensionWithoutAxis = "><"
+
+  axisLabel = (~"]" any)+
+
+  // Modifiers (highest precedence)
+  Modifier = urgent | strongPositive | highConfidence | lowConfidence
+
+  urgent = "!"
+  strongPositive = "++"
+  highConfidence = "*"
+  lowConfidence = "~"
+
+  // State markers
+  State = decidedWithFields | decidedWithoutFields
+        | blockedWithFields | blockedWithoutFields
+        | parkingWithFields | parkingWithoutFields
+        | exploring
+
+  decidedWithFields = "[decided(" decidedFields? ")]"
+  decidedFields = decidedField (space* "," space* decidedField)*
+  decidedField = rationalField | onField
+  rationalField = "rationale:" space* string
+  onField = "on:" space* dateString
+
+  decidedWithoutFields = "[decided]"
+
+  blockedWithFields = "[blocked(" blockedFields? ")]"
+  blockedFields = blockedField (space* "," space* blockedField)*
+  blockedField = reasonField | sinceField
+  reasonField = "reason:" space* string
+  sinceField = "since:" space* dateString
+
+  blockedWithoutFields = "[blocked]"
+
+  parkingWithFields = "[parking(" parkingFields? ")]"
+  parkingFields = parkingField (space* "," space* parkingField)*
+  parkingField = whyField | untilField
+  whyField = "why:" space* string
+  untilField = "until:" space* string
+
+  parkingWithoutFields = "[parking]"
+
+  exploring = "[exploring]"
+
+  // Insights, Questions, Commands
+  Insight = Thought | Action
+
+  // Insights can have optional relationship chains, or blocks
+  // Supports: text+block, just block, or just text
+  Thought = "thought:" space* thoughtText? Block? RelOpNodePair* "\n"?
+  Action = "action:" space* actionText? Block? RelOpNodePair* "\n"?
+
+  // Content excludes relationship operators and block delimiters (they're in RelOpNodePair)
+  // For text+block pattern, exclude { as well
+  // Exclude ; to allow semicolons as separators in horizontal syntax
+  thoughtText = (~("\n" | "}" | "{" | ";" | "->" | "<-" | "<=>" | "=>" | "><[" | "><") any)+
+  actionText = (~("\n" | "}" | "{" | ";" | "->" | "<-" | "<=>" | "=>" | "><[" | "><") any)+
+
+  Question = "?" space* questionText? Block? "\n"?
+  questionText = (~("\n" | "}" | "{" | ";") any)+
+
+  Completion = "✓" space* completionText? Block? "\n"?
+  completionText = (~("\n" | "}" | "{" | ";") any)+
+
+  // Alternatives
+  Alternative = "||" space* alternativeText? Block? "\n"?
+  alternativeText = (~("\n" | "}" | "{" | ";") any)+
+
+  // Lexical elements
+  string = "\"" stringChar* "\""
+  stringChar = ~("\"" | "\\") any
+             | escapeSequence
+
+  escapeSequence = "\\" ("\"" | "\\" | "n" | "t" | "r")
+
+  dateString = "\"" isoDate "\""
+  isoDate = digit digit digit digit "-" digit digit "-" digit digit
+           ("T" digit digit ":" digit digit ":" digit digit "Z")?
+
+  identifier = letter (letter | digit | "_" | "-")*
+
+  // Lexical rules (whitespace handling)
+  space := " " | "\t" | "\r"
+}

package/dist/hash.d.ts

@@ -0,0 +1,21 @@
+/**
+ * FlowScript Content Hashing
+ *
+ * Generates deterministic SHA-256 content hashes for nodes, relationships, and states.
+ * Enables automatic deduplication: same semantic content = same ID.
+ */
+/**
+ * Generate a SHA-256 content hash for any data object.
+ *
+ * The hash is deterministic - same input always produces same hash.
+ * This enables automatic deduplication in the IR graph.
+ *
+ * @param data - Any object to hash
+ * @returns 64-character lowercase hex string (SHA-256 hash)
+ *
+ * @example
+ * hashContent({ type: 'statement', content: 'Test' })
+ * // => 'a7f2c8d1b4e9f6a3c5d8e2b7f1a4c9d6e3b8a2f7c1d5e9b4a8f2c6d1e5a9b3f7'
+ */
+export declare function hashContent(data: any): string;
+//# sourceMappingURL=hash.d.ts.map