Decodie Core

Shared data layer for the Decodie ecosystem. Provides TypeScript types, a data parser, and a content-based reference resolver used by decodie-ui, decodie-ui-shared, and decodie-vscode.

What's included

• Types -- TypeScript interfaces for all .decodie/ data structures (index entries, session entries, config, references, resolutions)
• Parser -- Reads and caches index.json, session files, and config. Merges index metadata with session content. Supports cache invalidation for file watchers.
• Reference Resolver -- Content-based anchor matching that maps entries to source code using function signatures and class declarations instead of line numbers. Handles exact, fuzzy, drifted, and stale resolution statuses.

Installation

npm install @owenbush/decodie-core

Usage

import { DataParser, resolveReference } from '@owenbush/decodie-core';

const parser = new DataParser('/path/to/project');
const index = parser.loadIndex();
const entry = parser.getEntryWithContent('entry-1234-abcd');

Zero runtime dependencies

This package uses only Node.js built-ins (fs, path, crypto).

Tests

npm test

Related Repositories

• owenbush/decodie -- Main site and documentation.
• owenbush/decodie-skill -- Claude Code skill that generates .decodie/ data.
• owenbush/decodie-ui -- Web-based presentation layer.
• owenbush/decodie-vscode -- VSCode extension with sidebar entry browser and right-click analysis. Install from Marketplace.
• owenbush/decodie-ddev -- DDEV add-on.
• owenbush/decodie-github-action -- GitHub Action for automatic PR analysis. View on Marketplace.
• owenbush/decodie-github-bot -- Interactive bot for on-demand analysis and explanations in PR comments.