planfs-core 1.3.0 → 1.4.1

package/dist/semantic-formatter.js

@@ -0,0 +1,354 @@
+"use strict";
+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 });
+exports.SEMANTIC_FORMAT_VERSION = void 0;
+exports.previewSemanticFormats = previewSemanticFormats;
+exports.applySemanticFormats = applySemanticFormats;
+exports.previewSemanticEntityFormat = previewSemanticEntityFormat;
+const crypto_1 = require("crypto");
+const path = __importStar(require("path"));
+const files_1 = require("./files");
+const repository_1 = require("./repository");
+const semantic_1 = require("./semantic");
+const semantic_profiles_1 = require("./semantic-profiles");
+const semantic_validator_1 = require("./semantic-validator");
+exports.SEMANTIC_FORMAT_VERSION = '1.0.0';
+/** Preview deterministic Markdown-only normalization for a bounded entity list. */
+async function previewSemanticFormats(rootPath, entityIds) {
+    const repository = await (0, repository_1.loadRepository)(rootPath);
+    const entities = resolveEntities(repository, entityIds);
+    const previews = await Promise.all(entities.map(async (entity) => (previewSemanticEntityFormat(entity, await (0, files_1.readFile)(entity.filePath), rootPath))));
+    return batchPreview(previews);
+}
+/**
+ * Apply exactly the previously previewed source snapshots. Every proposed
+ * result is validated before the first bounded write occurs.
+ */
+async function applySemanticFormats(rootPath, entityIds, expectedFingerprints) {
+    const repository = await (0, repository_1.loadRepository)(rootPath);
+    const entities = resolveEntities(repository, entityIds);
+    const previews = await Promise.all(entities.map(async (entity) => (previewSemanticEntityFormat(entity, await (0, files_1.readFile)(entity.filePath), rootPath))));
+    for (const preview of previews.filter(item => item.changed)) {
+        const expected = expectedFingerprints[preview.entityId];
+        if (!expected) {
+            throw new Error(`Format apply requires the preview fingerprint for ${preview.entityId}`);
+        }
+        if (expected !== preview.sourceFingerprint) {
+            throw new Error(`Format conflict: ${preview.entityId} changed since preview`);
+        }
+        if (preview.blocked) {
+            throw new Error(`Format apply is blocked for ${preview.entityId}; review its formatter issues`);
+        }
+    }
+    const proposedRepository = repositoryWithFormattedBodies(repository, previews);
+    const selectedIds = new Set(previews.map(preview => preview.entityId));
+    const selectedPaths = new Set(previews.map(preview => preview.filePath));
+    const repositoryValidation = (0, repository_1.validateRepositoryState)(proposedRepository);
+    const selectedRepositoryErrors = repositoryValidation.errors.filter(error => (error.severity === 'error'
+        && ((error.id !== undefined && selectedIds.has(error.id))
+            || (error.path !== undefined && selectedPaths.has(error.path)))));
+    if (selectedRepositoryErrors.length > 0) {
+        const first = selectedRepositoryErrors[0];
+        throw new Error(`Formatted repository validation failed${first ? `: ${first.message}` : ''}`);
+    }
+    const semanticValidation = await (0, semantic_validator_1.validateSemanticRepository)(proposedRepository, { tier: 'baseline' });
+    const selectedSemanticErrors = semanticValidation.diagnostics.filter(diagnostic => (diagnostic.severity === 'error' && selectedIds.has(diagnostic.entityId)));
+    if (selectedSemanticErrors.length > 0) {
+        const first = selectedSemanticErrors[0];
+        throw new Error(`Formatted semantic validation failed${first ? `: ${first.code} ${first.message}` : ''}`);
+    }
+    // Recheck every source immediately before writing so validation cannot apply
+    // a stale snapshot after a human edit.
+    for (const preview of previews.filter(item => item.changed)) {
+        const current = await (0, files_1.readFile)(preview.filePath);
+        if (fingerprint(current) !== preview.sourceFingerprint) {
+            throw new Error(`Format conflict: ${preview.entityId} changed during validation`);
+        }
+    }
+    const appliedEntityIds = [];
+    for (const preview of previews.filter(item => item.changed)) {
+        await (0, files_1.writeFile)(preview.filePath, preview.formattedContent);
+        appliedEntityIds.push(preview.entityId);
+    }
+    return { ...batchPreview(previews), appliedEntityIds };
+}
+function previewSemanticEntityFormat(entity, sourceContent, rootPath = '') {
+    const { bodyStart, body } = splitFrontmatterBody(sourceContent);
+    const document = (0, semantic_1.parseSemanticDocument)(entity.type, body, { filePath: entity.filePath });
+    const profile = (0, semantic_profiles_1.getSemanticContentProfile)(entity.type);
+    const definitionByKey = new Map(profile.sections.map(definition => [definition.key, definition]));
+    const duplicateKeys = new Set(Object.entries(document.knownSections)
+        .filter(([, sections]) => sections.length > 1)
+        .map(([key]) => key));
+    const edits = [];
+    const issues = [];
+    for (const key of [...duplicateKeys].sort()) {
+        const sections = document.knownSections[key] ?? [];
+        issues.push({
+            code: 'format.section.duplicate-skipped',
+            severity: 'warning',
+            message: `Skipped '${key}' because the recognized section occurs ${sections.length} times; formatter does not merge duplicates.`,
+            sectionKey: key,
+            range: sections[1]?.headingRange ?? sections[0]?.headingRange ?? null,
+            blocksApply: false
+        });
+    }
+    const unsafeDiagnostics = document.diagnostics.filter(diagnostic => (diagnostic.conformance === 'baseline' && diagnostic.severity === 'error'));
+    for (const diagnostic of unsafeDiagnostics) {
+        issues.push({
+            code: 'format.document.unsafe',
+            severity: 'error',
+            message: `Cannot safely format this Markdown region: ${diagnostic.message}`,
+            sectionKey: sectionKeyAt(document.sections, diagnostic.sectionIndex),
+            range: diagnostic.range,
+            blocksApply: true
+        });
+    }
+    if (unsafeDiagnostics.length === 0) {
+        for (const section of document.sections) {
+            if (!section.key || duplicateKeys.has(section.key))
+                continue;
+            const definition = definitionByKey.get(section.key);
+            if (!definition)
+                continue;
+            addEdit(edits, {
+                kind: 'canonicalize-heading',
+                sectionKey: section.key,
+                range: section.headingRange,
+                start: section.headingRange.start.offset,
+                end: section.headingRange.end.offset,
+                before: body.slice(section.headingRange.start.offset, section.headingRange.end.offset),
+                after: `## ${definition.canonicalHeading}`
+            });
+        }
+        for (const criterion of document.criteria) {
+            const section = document.sections[criterion.sectionIndex];
+            if (!section?.key || duplicateKeys.has(section.key))
+                continue;
+            const lineEnd = nextLineEnding(body, criterion.range.start.offset);
+            const firstLine = body.slice(criterion.range.start.offset, lineEnd);
+            const taskMarker = /^(\s*)([-+*])[ \t]+\[([ xX])\][ \t]+/.exec(firstLine);
+            if (taskMarker?.[0]) {
+                const after = `${taskMarker[1] ?? ''}- [${criterion.checked === true ? 'x' : ' '}] `;
+                addEdit(edits, {
+                    kind: 'canonicalize-task-marker',
+                    sectionKey: section.key,
+                    range: rangePrefix(criterion.range, taskMarker[0].length, body),
+                    start: criterion.range.start.offset,
+                    end: criterion.range.start.offset + taskMarker[0].length,
+                    before: taskMarker[0],
+                    after
+                });
+                continue;
+            }
+            if (criterion.checked === null) {
+                const bullet = /^(\s*)([-+*])[ \t]+/.exec(firstLine);
+                if (bullet?.[0]) {
+                    addEdit(edits, {
+                        kind: 'add-task-marker',
+                        sectionKey: section.key,
+                        range: rangePrefix(criterion.range, bullet[0].length, body),
+                        start: criterion.range.start.offset,
+                        end: criterion.range.start.offset + bullet[0].length,
+                        before: bullet[0],
+                        after: `${bullet[1] ?? ''}- [ ] `
+                    });
+                }
+                else {
+                    issues.push({
+                        code: 'format.criterion.marker-skipped',
+                        severity: 'info',
+                        message: 'Skipped an ordinary criterion because its list marker cannot be losslessly converted to a task-list marker.',
+                        sectionKey: section.key,
+                        range: criterion.range,
+                        blocksApply: false
+                    });
+                }
+            }
+        }
+    }
+    edits.sort((left, right) => left.start - right.start || left.end - right.end);
+    assertNonOverlapping(edits);
+    const formattedBody = applyEdits(body, edits);
+    const formattedContent = sourceContent.slice(0, bodyStart) + formattedBody;
+    const publicEdits = edits.map(edit => ({
+        kind: edit.kind,
+        sectionKey: edit.sectionKey,
+        range: edit.range,
+        before: edit.before,
+        after: edit.after
+    }));
+    const filePath = rootPath ? path.relative(rootPath, entity.filePath) : entity.filePath;
+    return {
+        formatVersion: exports.SEMANTIC_FORMAT_VERSION,
+        entityId: entity.id,
+        entityType: entity.type,
+        filePath: entity.filePath,
+        sourceFingerprint: fingerprint(sourceContent),
+        changed: formattedContent !== sourceContent,
+        blocked: issues.some(issue => issue.blocksApply),
+        edits: publicEdits,
+        issues,
+        diff: renderEditDiff(filePath, body, publicEdits),
+        formattedContent
+    };
+}
+function resolveEntities(repository, requestedIds) {
+    const ids = [...new Set(requestedIds.map(id => id.trim()).filter(Boolean))].sort();
+    if (ids.length === 0)
+        throw new Error('Format requires at least one entity ID');
+    const byId = new Map((0, repository_1.getAllEntities)(repository).map(entity => [entity.id, entity]));
+    return ids.map(id => {
+        const entity = byId.get(id);
+        if (!entity)
+            throw new Error(`Entity not found: ${id}`);
+        return entity;
+    });
+}
+function batchPreview(previews) {
+    return {
+        formatVersion: exports.SEMANTIC_FORMAT_VERSION,
+        entityIds: previews.map(preview => preview.entityId),
+        changedEntityIds: previews.filter(preview => preview.changed).map(preview => preview.entityId),
+        blockedEntityIds: previews.filter(preview => preview.blocked).map(preview => preview.entityId),
+        expectedFingerprints: Object.fromEntries(previews
+            .filter(preview => preview.changed)
+            .map(preview => [preview.entityId, preview.sourceFingerprint])),
+        previews
+    };
+}
+function repositoryWithFormattedBodies(repository, previews) {
+    const bodies = new Map(previews.map(preview => [
+        preview.entityId,
+        splitFrontmatterBody(preview.formattedContent).body
+    ]));
+    const replace = (entities) => new Map([...entities].map(([id, entity]) => [id, {
+            ...entity,
+            body: bodies.get(id) ?? entity.body
+        }]));
+    return {
+        ...repository,
+        tasks: replace(repository.tasks),
+        epics: replace(repository.epics),
+        milestones: replace(repository.milestones),
+        decisions: replace(repository.decisions)
+    };
+}
+function splitFrontmatterBody(content) {
+    const opening = /^---[ \t]*(?:\r?\n|$)/.exec(content);
+    if (!opening)
+        throw new Error('Cannot format a file without YAML frontmatter');
+    const closingPattern = /^---[ \t]*(?:\r?\n|$)/gm;
+    closingPattern.lastIndex = opening[0].length;
+    const closing = closingPattern.exec(content);
+    if (!closing)
+        throw new Error('Cannot format a file with unclosed YAML frontmatter');
+    const bodyStart = closing.index + closing[0].length;
+    return { bodyStart, body: content.slice(bodyStart) };
+}
+function addEdit(edits, edit) {
+    if (edit.before !== edit.after)
+        edits.push(edit);
+}
+function nextLineEnding(source, offset) {
+    const newline = source.indexOf('\n', offset);
+    return newline >= 0 ? newline : source.length;
+}
+function rangePrefix(range, length, source) {
+    const prefix = source.slice(range.start.offset, range.start.offset + length);
+    const lines = prefix.split('\n');
+    return {
+        start: range.start,
+        end: lines.length === 1
+            ? { offset: range.start.offset + length, line: range.start.line, column: range.start.column + length }
+            : {
+                offset: range.start.offset + length,
+                line: range.start.line + lines.length - 1,
+                column: (lines[lines.length - 1]?.length ?? 0) + 1
+            }
+    };
+}
+function assertNonOverlapping(edits) {
+    for (let index = 1; index < edits.length; index += 1) {
+        const previous = edits[index - 1];
+        const current = edits[index];
+        if (previous && current && current.start < previous.end) {
+            throw new Error('Formatter produced overlapping edits and refused to continue');
+        }
+    }
+}
+function applyEdits(source, edits) {
+    let result = source;
+    for (const edit of [...edits].sort((left, right) => right.start - left.start)) {
+        if (source.slice(edit.start, edit.end) !== edit.before) {
+            throw new Error('Formatter edit no longer matches its source range');
+        }
+        result = result.slice(0, edit.start) + edit.after + result.slice(edit.end);
+    }
+    return result;
+}
+function fingerprint(content) {
+    return `sha256:${(0, crypto_1.createHash)('sha256').update(content, 'utf8').digest('hex')}`;
+}
+function sectionKeyAt(sections, index) {
+    return index === null ? null : sections[index]?.key ?? null;
+}
+function renderEditDiff(filePath, source, edits) {
+    if (edits.length === 0)
+        return '';
+    const lines = [`--- a/${filePath}`, `+++ b/${filePath}`];
+    for (const edit of edits) {
+        const display = displayEdit(source, edit);
+        lines.push(`@@ body:${edit.range.start.line}:${edit.range.start.column} ${edit.kind} @@`);
+        lines.push(...prefixDiffLines('-', display.before));
+        lines.push(...prefixDiffLines('+', display.after));
+    }
+    return lines.join('\n');
+}
+function displayEdit(source, edit) {
+    if (edit.before.includes('\n'))
+        return { before: edit.before, after: edit.after };
+    const lineStart = source.lastIndexOf('\n', Math.max(0, edit.range.start.offset - 1)) + 1;
+    const lineEnd = nextLineEnding(source, edit.range.end.offset);
+    const before = source.slice(lineStart, lineEnd).replace(/\r$/, '');
+    const relativeStart = edit.range.start.offset - lineStart;
+    const relativeEnd = edit.range.end.offset - lineStart;
+    const after = before.slice(0, relativeStart) + edit.after + before.slice(relativeEnd);
+    return { before, after };
+}
+function prefixDiffLines(prefix, value) {
+    return value.split('\n').map(line => `${prefix}${line}`);
+}
+//# sourceMappingURL=semantic-formatter.js.map

package/dist/semantic-formatter.js.map

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

package/dist/semantic-inspection.d.ts

@@ -0,0 +1,119 @@
+import { AdvisorySignal, AnalyzerResult, EntityMention, SemanticAnalyzer, SemanticDocument, SemanticFinding, SemanticCriterion, OrderedSection, SourceRange } from './semantic-types';
+import { CriterionCheckStatePolicy, SemanticValidationDiagnostic, SemanticValidationTier } from './semantic-validator';
+import { Entity } from './types';
+export type SemanticInspectionContractVersion = '1.0.0';
+export type SemanticInspectionView = 'all' | 'acceptance-criteria' | 'findings' | 'sections' | 'mentions' | 'relationships' | 'raw';
+export interface SemanticInspectionOptions {
+    tier?: SemanticValidationTier;
+    lifecycle?: boolean;
+    criterionCheckState?: CriterionCheckStatePolicy;
+    analysis?: boolean;
+    language?: string;
+    analyzer?: SemanticAnalyzer;
+}
+export interface SemanticInspectionEntity {
+    id: string;
+    type: Entity['type'];
+    title: string;
+    status: Entity['status'];
+    filePath: string;
+}
+export interface AuthoritativeRelationships {
+    dependsOn: string[];
+    epic: string | null;
+    milestone: string | null;
+    supersedes: string | null;
+    supersededBy: string | null;
+}
+export interface SemanticInspectionAuthoritative {
+    metadata: Record<string, unknown>;
+    relationships: AuthoritativeRelationships;
+}
+export interface SemanticAdvisoryConclusion {
+    code: string;
+    message: string;
+    range: SourceRange;
+    provenance: 'nlp-inferred';
+    authoritative: false;
+    signalKinds: string[];
+    repair: {
+        summary: string;
+        kind: 'edit-markdown' | 'edit-frontmatter';
+        previewable: boolean;
+    };
+    data: Record<string, string | number | boolean | null>;
+}
+export interface SemanticInspectionAdvisory {
+    mentions: EntityMention[];
+    conclusions: SemanticAdvisoryConclusion[];
+}
+export interface SemanticInspectionResult {
+    inspectionVersion: SemanticInspectionContractVersion;
+    entity: SemanticInspectionEntity;
+    authoritative: SemanticInspectionAuthoritative;
+    semantic: SemanticDocument;
+    advisory: SemanticInspectionAdvisory;
+    analysis: AnalyzerResult | null;
+    diagnostics: SemanticValidationDiagnostic[];
+}
+export type SemanticInspectionData = {
+    authoritative: SemanticInspectionAuthoritative;
+    semantic: SemanticDocument;
+    advisory: SemanticInspectionAdvisory;
+    analysis: AnalyzerResult | null;
+} | {
+    criteria: SemanticCriterion[];
+} | {
+    findings: SemanticFinding[];
+} | {
+    sections: OrderedSection[];
+} | {
+    mentions: EntityMention[];
+} | {
+    authoritativeRelationships: AuthoritativeRelationships;
+    advisoryMentions: EntityMention[];
+    relationshipSignals: AdvisorySignal[];
+} | {
+    rawMarkdown: string;
+};
+export interface SemanticInspectionViewResult {
+    inspectionVersion: SemanticInspectionContractVersion;
+    view: SemanticInspectionView;
+    entity: SemanticInspectionEntity;
+    data: SemanticInspectionData;
+    diagnostics: SemanticValidationDiagnostic[];
+}
+export interface SemanticInspectionCacheOptions {
+    capacity?: number;
+}
+export interface SemanticInspectionCacheStats {
+    size: number;
+    capacity: number;
+    hits: number;
+    misses: number;
+    evictions: number;
+}
+/**
+ * Bounded per-consumer cache for repeated inspection of unchanged entities.
+ * Callers opt in so one-shot CLI commands do not retain repository bodies.
+ */
+export declare class SemanticInspectionCache {
+    private readonly entries;
+    private readonly capacity;
+    private hits;
+    private misses;
+    private evictions;
+    constructor(options?: SemanticInspectionCacheOptions);
+    get stats(): SemanticInspectionCacheStats;
+    clear(): void;
+    inspect(entity: Entity, options?: SemanticInspectionOptions): Promise<SemanticInspectionResult>;
+}
+/**
+ * Build a read-only semantic inspection result for one already loaded entity.
+ * Analysis is optional at the core boundary; interactive callers may enable it
+ * by default while deterministic automation can leave it disabled.
+ */
+export declare function inspectSemanticEntity(entity: Entity, options?: SemanticInspectionOptions): Promise<SemanticInspectionResult>;
+/** Select a deterministic, focused JSON-ready view without reparsing Markdown. */
+export declare function selectSemanticInspectionView(inspection: SemanticInspectionResult, view?: SemanticInspectionView): SemanticInspectionViewResult;
+//# sourceMappingURL=semantic-inspection.d.ts.map

package/dist/semantic-inspection.d.ts.map

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