@leji-org/leji 1.0.0

package/dist/commands/indexgen.d.ts

@@ -0,0 +1,55 @@
+import { type Finding } from '../lib/findings.js';
+import { type Manifest } from '../lib/manifest.js';
+export interface IndexEntry {
+    id: string;
+    path: string;
+    title: string;
+    category: string;
+    summary?: string;
+    tags?: string[];
+    owners?: string[];
+    lastModified?: string;
+    contentHash?: string;
+    freshness?: {
+        reviewAfter: string;
+    };
+    links?: string[];
+}
+export interface ContextIndex {
+    $schema?: string;
+    schemaVersion: string;
+    generatedAt: string;
+    generator?: {
+        name?: string;
+        version?: string;
+    };
+    rootPath: string;
+    entries: IndexEntry[];
+}
+export interface IndexResult {
+    index: ContextIndex | null;
+    findings: Finding[];
+    /** Set by check(): true when the stored index no longer matches the tree. */
+    stale?: boolean;
+}
+export declare function declaredIndexPath(manifest: Manifest): string | null;
+export declare function loadStoredIndex(root: string, manifest: Manifest): ContextIndex | null;
+/**
+ * Generate the context index from the tree. Id stability, in priority order:
+ * document frontmatter `id`, the stored index's id for the same path, the
+ * stored index's id for the same contentHash (a pure move), then a filename
+ * slug (de-collided with the parent directory).
+ */
+export declare function generateIndex(root: string, manifest: Manifest): IndexResult;
+/** Key-order-insensitive serialization, mirrored by the Python SDK. */
+export declare function stableStringify(value: unknown): string;
+/**
+ * Check the stored index against a regeneration. `generatedAt`, `generator`,
+ * and `lastModified` are excluded from the comparison: content drift is what
+ * `contentHash` catches deterministically.
+ */
+export declare function checkIndex(root: string, manifest: Manifest): IndexResult;
+/** Serialize an index with stable key order, 2-space indent, trailing newline. */
+export declare function serializeIndex(index: ContextIndex): string;
+/** Generate and write the index to the declared path. */
+export declare function writeIndex(root: string, manifest: Manifest): IndexResult;

package/dist/commands/indexgen.js

@@ -0,0 +1,256 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { finding } from '../lib/findings.js';
+import { isFile, realpathWithin } from '../lib/fsx.js';
+import { gitLastModified, gitToplevel } from '../lib/git.js';
+import { duplicateIdFindings, readJsonArtifact, scanCategories } from '../lib/layer.js';
+import { SDK_VERSION, SUPPORTED_LINES, schemaErrors } from '../lib/schemas.js';
+const ID_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+function slugify(stem) {
+    return stem
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function firstHeading(body) {
+    const m = /^#\s+(.+)$/m.exec(body);
+    return m ? m[1].trim() : null;
+}
+function contentHash(root, relPath) {
+    const buf = fs.readFileSync(path.join(root, relPath));
+    return 'sha256:' + crypto.createHash('sha256').update(buf).digest('hex').slice(0, 16);
+}
+function str(v) {
+    return typeof v === 'string' && v !== '' ? v : undefined;
+}
+function strArray(v) {
+    if (!Array.isArray(v))
+        return undefined;
+    const out = v.filter((x) => typeof x === 'string');
+    return out.length > 0 ? out : undefined;
+}
+export function declaredIndexPath(manifest) {
+    return manifest.machine?.indexPath ?? null;
+}
+export function loadStoredIndex(root, manifest) {
+    const rel = declaredIndexPath(manifest);
+    if (!rel || !isFile(path.join(root, rel)))
+        return null;
+    const { data } = readJsonArtifact(root, rel);
+    if (!data || typeof data !== 'object')
+        return null;
+    return data;
+}
+/**
+ * Generate the context index from the tree. Id stability, in priority order:
+ * document frontmatter `id`, the stored index's id for the same path, the
+ * stored index's id for the same contentHash (a pure move), then a filename
+ * slug (de-collided with the parent directory).
+ */
+export function generateIndex(root, manifest) {
+    const findings = [];
+    const docs = scanCategories(root, manifest);
+    const stored = loadStoredIndex(root, manifest);
+    const storedByPath = new Map();
+    const storedByHash = new Map();
+    for (const entry of stored?.entries ?? []) {
+        storedByPath.set(entry.path, entry);
+        if (entry.contentHash)
+            storedByHash.set(entry.contentHash, entry);
+    }
+    const inGit = gitToplevel(root) !== null;
+    const today = new Date().toISOString().slice(0, 10);
+    const used = new Map();
+    const entries = [];
+    for (const doc of docs) {
+        const fm = doc.frontmatter ?? {};
+        const hash = contentHash(root, doc.relPath);
+        const carried = storedByPath.get(doc.relPath) ?? storedByHash.get(hash);
+        let id = str(fm.id) ?? carried?.id;
+        if (!id) {
+            const stem = path.posix.basename(doc.relPath).replace(/\.md$/, '');
+            id = slugify(stem);
+            if (used.has(id)) {
+                const parent = slugify(path.posix.basename(path.posix.dirname(doc.relPath)));
+                id = parent ? `${parent}-${id}` : id;
+            }
+            let candidate = id;
+            let n = 2;
+            while (used.has(candidate))
+                candidate = `${id}-${n++}`;
+            id = candidate;
+        }
+        if (!ID_PATTERN.test(id)) {
+            findings.push(finding('id-pattern', 'error', `derived id "${id}" is not lowercase-hyphen`, doc.relPath));
+        }
+        if (used.has(id)) {
+            findings.push(finding('id-duplicate', 'error', `index id "${id}" already used by ${used.get(id)}`, doc.relPath));
+        }
+        used.set(id, doc.relPath);
+        const entry = {
+            id,
+            path: doc.relPath,
+            title: str(fm.title) ?? firstHeading(doc.body) ?? path.posix.basename(doc.relPath).replace(/\.md$/, ''),
+            category: doc.category,
+        };
+        const summary = str(fm.summary) ?? carried?.summary;
+        if (summary)
+            entry.summary = summary;
+        const tags = strArray(fm.tags);
+        if (tags)
+            entry.tags = tags;
+        const owners = strArray(fm.owners);
+        if (owners)
+            entry.owners = owners;
+        entry.lastModified = (inGit ? gitLastModified(root, doc.relPath) : null) ?? today;
+        entry.contentHash = hash;
+        const freshness = fm.freshness;
+        const reviewAfter = str(freshness?.reviewAfter);
+        if (reviewAfter)
+            entry.freshness = { reviewAfter };
+        const links = strArray(fm.links);
+        if (links)
+            entry.links = links;
+        entries.push(entry);
+    }
+    const index = {
+        $schema: 'https://leji.org/schemas/v1.0/context-index.schema.json',
+        schemaVersion: '1.0',
+        generatedAt: new Date().toISOString(),
+        generator: { name: 'leji', version: SDK_VERSION },
+        rootPath: manifest.rootPath,
+        entries,
+    };
+    return { index, findings };
+}
+/** Fields compared for currency; volatile fields are deliberately excluded. */
+function comparable(entry) {
+    const { lastModified: _lastModified, ...rest } = entry;
+    return rest;
+}
+/** Key-order-insensitive serialization, mirrored by the Python SDK. */
+export function stableStringify(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    if (value !== null && typeof value === 'object') {
+        const keys = Object.keys(value).sort();
+        return `{${keys
+            .map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Check the stored index against a regeneration. `generatedAt`, `generator`,
+ * and `lastModified` are excluded from the comparison: content drift is what
+ * `contentHash` catches deterministically.
+ */
+export function checkIndex(root, manifest) {
+    const rel = declaredIndexPath(manifest);
+    const findings = [];
+    if (!rel || !isFile(path.join(root, rel))) {
+        findings.push(finding('index-required', 'error', rel
+            ? `declared index ${rel} does not exist; run \`leji index\``
+            : 'no machine.indexPath declared in leji.json', rel ?? 'leji.json'));
+        return { index: null, findings, stale: true };
+    }
+    const stored = loadStoredIndex(root, manifest);
+    if (!stored) {
+        findings.push(finding('artifact-parse', 'error', 'stored index is not valid JSON', rel));
+        return { index: null, findings, stale: true };
+    }
+    for (const err of schemaErrors('context-index', stored)) {
+        findings.push(finding('artifact-schema', 'error', err, rel));
+    }
+    if (typeof stored.schemaVersion === 'string' && !SUPPORTED_LINES.includes(stored.schemaVersion)) {
+        findings.push(finding('schema-version', 'error', `schemaVersion "${stored.schemaVersion}" is not supported by this SDK`, rel));
+    }
+    if (findings.length > 0)
+        return { index: stored, findings, stale: true };
+    const regen = generateIndex(root, manifest);
+    const want = stableStringify({
+        rootPath: regen.index.rootPath,
+        entries: regen.index.entries.map(comparable),
+    });
+    const got = stableStringify({
+        rootPath: stored.rootPath,
+        entries: [...stored.entries].sort((a, b) => (a.path < b.path ? -1 : 1)).map(comparable),
+    });
+    if (want !== got) {
+        const wantPaths = new Set(regen.index.entries.map((e) => e.path));
+        const gotPaths = new Set(stored.entries.map((e) => e.path));
+        const missing = [...wantPaths].filter((p) => !gotPaths.has(p));
+        const extra = [...gotPaths].filter((p) => !wantPaths.has(p));
+        const detail = missing.length > 0 || extra.length > 0
+            ? ` (missing: ${missing.length}, removed: ${extra.length})`
+            : ' (entry content drifted)';
+        findings.push(finding('index-stale', 'error', `index no longer matches the tree${detail}; run \`leji index\``, rel));
+        return { index: stored, findings, stale: true };
+    }
+    return {
+        index: stored,
+        findings: duplicateIdFindings(stored.entries.map((e) => ({ id: e.id, relPath: e.path })), 'index'),
+        stale: false,
+    };
+}
+const ENTRY_KEY_ORDER = [
+    'id',
+    'path',
+    'title',
+    'category',
+    'summary',
+    'tags',
+    'owners',
+    'lastModified',
+    'contentHash',
+    'freshness',
+    'links',
+];
+function orderedEntry(entry) {
+    const out = {};
+    for (const key of ENTRY_KEY_ORDER) {
+        if (entry[key] !== undefined)
+            out[key] = entry[key];
+    }
+    return out;
+}
+/** Serialize an index with stable key order, 2-space indent, trailing newline. */
+export function serializeIndex(index) {
+    const out = {
+        $schema: index.$schema,
+        schemaVersion: index.schemaVersion,
+        generatedAt: index.generatedAt,
+        generator: index.generator,
+        rootPath: index.rootPath,
+        entries: index.entries.map(orderedEntry),
+    };
+    return JSON.stringify(out, null, 2) + '\n';
+}
+/** Generate and write the index to the declared path. */
+export function writeIndex(root, manifest) {
+    const rel = declaredIndexPath(manifest);
+    if (!rel) {
+        return {
+            index: null,
+            findings: [finding('index-required', 'error', 'no machine.indexPath declared in leji.json', 'leji.json')],
+        };
+    }
+    const result = generateIndex(root, manifest);
+    if (result.index) {
+        const abs = path.join(root, rel);
+        fs.mkdirSync(path.dirname(abs), { recursive: true });
+        if (!realpathWithin(path.resolve(root), abs)) {
+            return {
+                index: result.index,
+                findings: [
+                    ...result.findings,
+                    finding('artifact-parse', 'error', `index path ${rel} resolves outside the layer root`, rel),
+                ],
+            };
+        }
+        fs.writeFileSync(abs, serializeIndex(result.index));
+    }
+    return result;
+}
+//# sourceMappingURL=indexgen.js.map

package/dist/commands/indexgen.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,28 @@
+import { type CategoryId, type Manifest } from '../lib/manifest.js';
+export interface InitOptions {
+    dir: string;
+    yes: boolean;
+    name?: string;
+    level?: 'core' | 'indexed';
+}
+export interface InitAnswers {
+    name: string;
+    description: string;
+    rootPath: string;
+    ownerName: string;
+    ownerContact: string;
+    categories: CategoryId[];
+    level: 'core' | 'indexed';
+}
+export interface InitResult {
+    written: string[];
+    manifest: Manifest;
+}
+/**
+ * Bootstrap a context layer from the vendored templates. Interactive unless
+ * --yes. Refuses to run when leji.json already exists; never overwrites
+ * existing files (seeds land only where nothing is in the way).
+ */
+export declare function initLayer(options: InitOptions): Promise<InitResult>;
+/** Post-init guidance, printed by the CLI. */
+export declare function enteringTheLayer(manifest: Manifest): string;