@planu/cli 0.63.7 → 0.64.1

package/dist/engine/spec-versioning/differ.js

@@ -0,0 +1,151 @@
+// engine/spec-versioning/differ.ts — Diff two spec versions at AC-level granularity
+import { getVersion } from './version-store.js';
+import { extractAcceptanceCriteria } from '../shared/ac-extractor.js';
+import { computeLineDiff } from '../shared/line-diff.js';
+export { extractAcceptanceCriteria, computeLineDiff };
+/** Extract section headers from spec content. */
+function extractSectionHeaders(content) {
+    return content
+        .split('\n')
+        .filter((line) => /^#+\s/.test(line.trim()))
+        .map((line) => line.trim());
+}
+/** Compute AC-level diff between two sets of criteria. */
+export function computeAcDiff(fromCriteria, toCriteria) {
+    const fromSet = new Set(fromCriteria);
+    const toSet = new Set(toCriteria);
+    const added = [];
+    const removed = [];
+    const modified = [];
+    // Find removed and potentially modified
+    for (const criterion of fromCriteria) {
+        if (!toSet.has(criterion)) {
+            // Check if it was modified (high similarity match)
+            const similar = findSimilar(criterion, toCriteria, fromCriteria);
+            if (similar !== null && !fromSet.has(similar)) {
+                modified.push({ before: criterion, after: similar });
+                toSet.delete(similar); // Mark as consumed
+            }
+            else {
+                removed.push(criterion);
+            }
+        }
+    }
+    // Find added (those in toCriteria not matched yet)
+    for (const criterion of toCriteria) {
+        if (!fromSet.has(criterion) && !modified.some((m) => m.after === criterion)) {
+            added.push(criterion);
+        }
+    }
+    return { added, removed, modified };
+}
+/** Find the most similar string in a list (similarity > 0.5). Returns null if none. */
+function findSimilar(target, candidates, excludeFrom) {
+    const excludeSet = new Set(excludeFrom);
+    let bestScore = 0.5; // threshold
+    let bestMatch = null;
+    for (const candidate of candidates) {
+        if (excludeSet.has(candidate)) {
+            continue;
+        }
+        const score = bigramSimilarity(target, candidate);
+        if (score > bestScore) {
+            bestScore = score;
+            bestMatch = candidate;
+        }
+    }
+    return bestMatch;
+}
+/** Compute bigram similarity between two strings (0–1). */
+function bigramSimilarity(a, b) {
+    if (a === b) {
+        return 1;
+    }
+    if (a.length < 2 || b.length < 2) {
+        return 0;
+    }
+    const buildBigrams = (str) => {
+        const bigrams = new Set();
+        for (let i = 0; i < str.length - 1; i++) {
+            bigrams.add(str.slice(i, i + 2));
+        }
+        return bigrams;
+    };
+    const bigramsA = buildBigrams(a.toLowerCase());
+    const bigramsB = buildBigrams(b.toLowerCase());
+    let intersection = 0;
+    for (const bigram of bigramsA) {
+        if (bigramsB.has(bigram)) {
+            intersection++;
+        }
+    }
+    return (2 * intersection) / (bigramsA.size + bigramsB.size);
+}
+/** Detect which sections changed between two spec contents. */
+export function detectSectionChanges(fromContent, toContent) {
+    const fromHeaders = new Set(extractSectionHeaders(fromContent));
+    const toHeaders = new Set(extractSectionHeaders(toContent));
+    const changes = [];
+    for (const header of toHeaders) {
+        if (!fromHeaders.has(header)) {
+            changes.push(`Added section: ${header}`);
+        }
+    }
+    for (const header of fromHeaders) {
+        if (!toHeaders.has(header)) {
+            changes.push(`Removed section: ${header}`);
+        }
+    }
+    return changes;
+}
+/**
+ * Diff two spec versions stored on disk.
+ * Throws if either version tag is not found.
+ */
+export async function diffVersions(dataDir, specId, fromTag, toTag) {
+    const [fromVersion, toVersion] = await Promise.all([
+        getVersion(dataDir, specId, fromTag),
+        getVersion(dataDir, specId, toTag),
+    ]);
+    if (fromVersion === null) {
+        throw new Error(`Version "${fromTag}" not found for spec ${specId}.`);
+    }
+    if (toVersion === null) {
+        throw new Error(`Version "${toTag}" not found for spec ${specId}.`);
+    }
+    const { added, removed } = computeLineDiff(fromVersion.content, toVersion.content);
+    const fromCriteria = extractAcceptanceCriteria(fromVersion.content);
+    const toCriteria = extractAcceptanceCriteria(toVersion.content);
+    const criteriaChanges = computeAcDiff(fromCriteria, toCriteria);
+    const sectionChanges = detectSectionChanges(fromVersion.content, toVersion.content);
+    return {
+        fromTag,
+        toTag,
+        specId,
+        added,
+        removed,
+        criteriaChanges,
+        sectionChanges,
+    };
+}
+/**
+ * Diff two spec content strings directly (no disk lookup).
+ * Used before merging to show what will change.
+ */
+export function diffContents(specId, fromTag, toTag, fromContent, toContent) {
+    const { added, removed } = computeLineDiff(fromContent, toContent);
+    const fromCriteria = extractAcceptanceCriteria(fromContent);
+    const toCriteria = extractAcceptanceCriteria(toContent);
+    const criteriaChanges = computeAcDiff(fromCriteria, toCriteria);
+    const sectionChanges = detectSectionChanges(fromContent, toContent);
+    return {
+        fromTag,
+        toTag,
+        specId,
+        added,
+        removed,
+        criteriaChanges,
+        sectionChanges,
+    };
+}
+//# sourceMappingURL=differ.js.map

package/dist/engine/spec-versioning/differ.js.map

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

package/dist/engine/spec-versioning/index.d.ts

@@ -0,0 +1,5 @@
+export * from './version-store.js';
+export * from './brancher.js';
+export * from './differ.js';
+export * from './merger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/spec-versioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-versioning/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/engine/spec-versioning/index.js

@@ -0,0 +1,6 @@
+// engine/spec-versioning/index.ts — Barrel export for spec-versioning module
+export * from './version-store.js';
+export * from './brancher.js';
+export * from './differ.js';
+export * from './merger.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/spec-versioning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/spec-versioning/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/engine/spec-versioning/merger.d.ts

@@ -0,0 +1,18 @@
+import type { SpecMergeResult, SpecMergeConflict, MergeSpecBranchInput } from '../../types/index.js';
+/**
+ * Detect merge conflicts between branch content and latest main content.
+ * Simple strategy: if the branch diverged from the latest version, flag it.
+ */
+export declare function detectConflicts(baseContent: string, branchContent: string, mainContent: string): SpecMergeConflict[];
+/**
+ * Attempt a simple auto-merge: apply branch additions to main content.
+ * Returns merged content or null if auto-merge is not safe.
+ */
+export declare function autoMerge(branchContent: string, mainContent: string): string | null;
+/**
+ * Merge a spec branch back into main.
+ * Creates a new version snapshot with the merged content.
+ * Deletes the branch on success.
+ */
+export declare function mergeBranch(dataDir: string, input: MergeSpecBranchInput): Promise<SpecMergeResult>;
+//# sourceMappingURL=merger.d.ts.map

package/dist/engine/spec-versioning/merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-versioning/merger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAU9B;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,iBAAiB,EAAE,CA2BrB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASnF;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,eAAe,CAAC,CA+E1B"}

package/dist/engine/spec-versioning/merger.js

@@ -0,0 +1,113 @@
+// engine/spec-versioning/merger.ts — Merge a spec branch back into main with conflict detection
+import { loadBranch, deleteBranch } from './brancher.js';
+import { createVersion, getLatestVersionTag, loadVersionStore, suggestNextTag, } from './version-store.js';
+import { diffContents } from './differ.js';
+/**
+ * Detect merge conflicts between branch content and latest main content.
+ * Simple strategy: if the branch diverged from the latest version, flag it.
+ */
+export function detectConflicts(baseContent, branchContent, mainContent) {
+    const conflicts = [];
+    // If main content changed from the base (concurrent edit), flag it
+    if (mainContent !== baseContent) {
+        const mainLines = new Set(mainContent.split('\n'));
+        const branchLines = branchContent.split('\n');
+        const conflictingLines = [];
+        for (const line of branchLines) {
+            if (line.trim().length > 0 && !mainLines.has(line)) {
+                conflictingLines.push(line.trim());
+            }
+        }
+        if (conflictingLines.length > 0) {
+            conflicts.push({
+                type: 'concurrent_edit',
+                description: 'The main spec was modified after the branch was created. ' +
+                    'Some branch changes conflict with current main content.',
+                details: conflictingLines.slice(0, 10), // Show up to 10 conflicting lines
+            });
+        }
+    }
+    return conflicts;
+}
+/**
+ * Attempt a simple auto-merge: apply branch additions to main content.
+ * Returns merged content or null if auto-merge is not safe.
+ */
+export function autoMerge(branchContent, mainContent) {
+    // Simple strategy: if main has no divergence (same as base), use branch content directly
+    if (branchContent === mainContent) {
+        return mainContent;
+    }
+    // For now, trust branch content as the resolved merge when no conflicts are critical
+    // A more sophisticated approach would do 3-way merge, but that requires the base content
+    return branchContent;
+}
+/**
+ * Merge a spec branch back into main.
+ * Creates a new version snapshot with the merged content.
+ * Deletes the branch on success.
+ */
+export async function mergeBranch(dataDir, input) {
+    const { specId, branchName, message } = input;
+    // Load the branch
+    const branch = await loadBranch(dataDir, specId, branchName);
+    if (branch === null) {
+        return {
+            success: false,
+            specId,
+            branchName,
+            conflicts: [],
+            message: `Branch "${branchName}" not found for spec ${specId}.`,
+        };
+    }
+    // Load the current main spec content (latest version snapshot)
+    const versionStore = await loadVersionStore(dataDir, specId);
+    const latestSnapshot = versionStore.versions[versionStore.versions.length - 1];
+    const mainContent = latestSnapshot?.content ?? '';
+    // Determine the content to use for the merge
+    const resolvedContent = input.resolvedContent ?? autoMerge(branch.content, mainContent);
+    if (resolvedContent === null) {
+        return {
+            success: false,
+            specId,
+            branchName,
+            conflicts: [
+                {
+                    type: 'content_diverged',
+                    description: 'Auto-merge failed. Provide resolvedContent to complete the merge.',
+                    details: [],
+                },
+            ],
+            message: 'Merge failed: could not auto-merge. Please provide resolvedContent.',
+        };
+    }
+    // Determine the new version tag
+    const latestTag = await getLatestVersionTag(dataDir, specId);
+    const newVersionTag = input.newVersionTag ?? suggestNextTag(latestTag);
+    // Create the new version snapshot
+    const newVersion = await createVersion(dataDir, {
+        projectId: input.projectId,
+        specId,
+        tag: newVersionTag,
+        content: resolvedContent,
+        message: message ?? `Merged branch "${branchName}" into main`,
+        author: `merge:${branchName}`,
+    });
+    // Compute diff for reporting
+    const diff = diffContents(specId, branch.fromVersion, newVersionTag, branch.content, resolvedContent);
+    // Delete the branch after successful merge
+    await deleteBranch(dataDir, specId, branchName);
+    const totalChanges = diff.criteriaChanges.added.length +
+        diff.criteriaChanges.removed.length +
+        diff.criteriaChanges.modified.length;
+    return {
+        success: true,
+        specId,
+        branchName,
+        newVersionTag: newVersion.tag,
+        conflicts: [],
+        message: `Merged branch "${branchName}" into spec ${specId} as version ${newVersion.tag}. ` +
+            `${totalChanges} AC-level change(s) detected.`,
+    };
+}
+//# sourceMappingURL=merger.js.map

package/dist/engine/spec-versioning/merger.js.map

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

package/dist/engine/spec-versioning/version-store.d.ts

@@ -0,0 +1,18 @@
+import type { SpecVersionSnapshot, SpecVersionSnapshotStore, CreateVersionSnapshotInput } from '../../types/index.js';
+/** Build the storage directory for a spec's versions. */
+export declare function getVersionsDir(dataDir: string, specId: string): string;
+/** Load the version store for a spec. Returns empty store if not found. */
+export declare function loadVersionStore(dataDir: string, specId: string): Promise<SpecVersionSnapshotStore>;
+/** Validate that a tag matches semantic versioning (vMAJOR.MINOR.PATCH). */
+export declare function isValidVersionTag(tag: string): boolean;
+/** Create and persist a new version snapshot. Returns the created snapshot. */
+export declare function createVersion(dataDir: string, input: CreateVersionSnapshotInput): Promise<SpecVersionSnapshot>;
+/** Retrieve a specific snapshot by tag. Returns null if not found. */
+export declare function getVersion(dataDir: string, specId: string, tag: string): Promise<SpecVersionSnapshot | null>;
+/** List all snapshots for a spec, ordered from oldest to newest. */
+export declare function listVersions(dataDir: string, specId: string): Promise<SpecVersionSnapshot[]>;
+/** Get the latest version tag for a spec. Returns null if no versions exist. */
+export declare function getLatestVersionTag(dataDir: string, specId: string): Promise<string | null>;
+/** Suggest the next patch version given the current latest tag. */
+export declare function suggestNextTag(latestTag: string | null): string;
+//# sourceMappingURL=version-store.d.ts.map

package/dist/engine/spec-versioning/version-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-store.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-versioning/version-store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAI9B,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAOD,2EAA2E;AAC3E,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CAQnC;AAgBD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAOD,+EAA+E;AAC/E,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,mBAAmB,CAAC,CA0B9B;AAED,sEAAsE;AACtE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAGrC;AAED,oEAAoE;AACpE,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAKhC;AAED,gFAAgF;AAChF,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOjG;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAY/D"}

package/dist/engine/spec-versioning/version-store.js

@@ -0,0 +1,96 @@
+// engine/spec-versioning/version-store.ts — Store and retrieve spec version snapshots
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+const VERSIONS_FILENAME = 'versions.json';
+/** Build the storage directory for a spec's versions. */
+export function getVersionsDir(dataDir, specId) {
+    return join(dataDir, 'spec-versions', specId);
+}
+/** Build the path to the versions.json file for a spec. */
+function getVersionsFilePath(dataDir, specId) {
+    return join(getVersionsDir(dataDir, specId), VERSIONS_FILENAME);
+}
+/** Load the version store for a spec. Returns empty store if not found. */
+export async function loadVersionStore(dataDir, specId) {
+    const filePath = getVersionsFilePath(dataDir, specId);
+    try {
+        const raw = await readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return { specId, versions: [] };
+    }
+}
+/** Persist the version store to disk. Creates directories as needed. */
+async function saveVersionStore(dataDir, specId, store) {
+    const dir = getVersionsDir(dataDir, specId);
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    const filePath = join(dir, VERSIONS_FILENAME);
+    await writeFile(filePath, JSON.stringify(store, null, 2), 'utf-8');
+}
+/** Validate that a tag matches semantic versioning (vMAJOR.MINOR.PATCH). */
+export function isValidVersionTag(tag) {
+    return /^v\d+\.\d+\.\d+$/.test(tag);
+}
+/** Check if a tag already exists in the store. */
+function tagExists(store, tag) {
+    return store.versions.some((v) => v.tag === tag);
+}
+/** Create and persist a new version snapshot. Returns the created snapshot. */
+export async function createVersion(dataDir, input) {
+    const { specId, tag, content, message, author } = input;
+    if (!isValidVersionTag(tag)) {
+        throw new Error(`Invalid version tag "${tag}". Use semantic versioning format: v1.0.0, v1.1.0, v2.0.0`);
+    }
+    const store = await loadVersionStore(dataDir, specId);
+    if (tagExists(store, tag)) {
+        throw new Error(`Version "${tag}" already exists for spec ${specId}. Use a different tag.`);
+    }
+    const version = {
+        tag,
+        timestamp: new Date().toISOString(),
+        content,
+        ...(message !== undefined ? { message } : {}),
+        ...(author !== undefined ? { author } : {}),
+    };
+    store.versions.push(version);
+    await saveVersionStore(dataDir, specId, store);
+    return version;
+}
+/** Retrieve a specific snapshot by tag. Returns null if not found. */
+export async function getVersion(dataDir, specId, tag) {
+    const store = await loadVersionStore(dataDir, specId);
+    return store.versions.find((v) => v.tag === tag) ?? null;
+}
+/** List all snapshots for a spec, ordered from oldest to newest. */
+export async function listVersions(dataDir, specId) {
+    const store = await loadVersionStore(dataDir, specId);
+    return [...store.versions].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+}
+/** Get the latest version tag for a spec. Returns null if no versions exist. */
+export async function getLatestVersionTag(dataDir, specId) {
+    const versions = await listVersions(dataDir, specId);
+    if (versions.length === 0) {
+        return null;
+    }
+    const latest = versions[versions.length - 1];
+    return latest?.tag ?? null;
+}
+/** Suggest the next patch version given the current latest tag. */
+export function suggestNextTag(latestTag) {
+    if (latestTag === null) {
+        return 'v1.0.0';
+    }
+    const match = /^v(\d+)\.(\d+)\.(\d+)$/.exec(latestTag);
+    if (!match) {
+        return 'v1.0.0';
+    }
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    const patch = Number(match[3]);
+    return `v${major}.${minor}.${patch + 1}`;
+}
+//# sourceMappingURL=version-store.js.map

package/dist/engine/spec-versioning/version-store.js.map

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

package/dist/engine/well-known/discovery.d.ts

@@ -0,0 +1,7 @@
+import type { DiscoveryResult } from '../../types/well-known.js';
+/**
+ * Parse and validate a .well-known/planu.json manifest from a raw JSON string.
+ * Returns a DiscoveryResult with the parsed manifest or validation errors.
+ */
+export declare function parseManifest(source: string, rawJson: string): DiscoveryResult;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/engine/well-known/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/engine/well-known/discovery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmC,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA+FlG;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAiC9E"}

package/dist/engine/well-known/discovery.js

@@ -0,0 +1,109 @@
+// engine/well-known/discovery.ts — SPEC-162: Parse and validate a .well-known/planu.json manifest
+/** Validate that a value is a non-empty string. */
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/** Validate a single ManifestSpec entry. Returns error strings or empty array. */
+function validateManifestSpec(spec, index) {
+    const errors = [];
+    const prefix = `specs[${String(index)}]`;
+    if (spec === null || typeof spec !== 'object') {
+        return [`${prefix}: must be an object`];
+    }
+    const s = spec;
+    if (!isNonEmptyString(s.id)) {
+        errors.push(`${prefix}.id: must be a non-empty string`);
+    }
+    else if (!/^SPEC-\d+$/.test(s.id)) {
+        errors.push(`${prefix}.id: must match pattern SPEC-NNN (e.g. SPEC-001)`);
+    }
+    if (!isNonEmptyString(s.title)) {
+        errors.push(`${prefix}.title: must be a non-empty string`);
+    }
+    if (!isNonEmptyString(s.status)) {
+        errors.push(`${prefix}.status: must be a non-empty string`);
+    }
+    if (!isNonEmptyString(s.type)) {
+        errors.push(`${prefix}.type: must be a non-empty string`);
+    }
+    if (typeof s.description !== 'string') {
+        errors.push(`${prefix}.description: must be a string`);
+    }
+    if (!Array.isArray(s.tags)) {
+        errors.push(`${prefix}.tags: must be an array`);
+    }
+    if (!isNonEmptyString(s.created)) {
+        errors.push(`${prefix}.created: must be a non-empty string`);
+    }
+    return errors;
+}
+/** Validate the top-level structure of a parsed manifest object. */
+function validateManifestShape(raw) {
+    const errors = [];
+    if (raw === null || typeof raw !== 'object') {
+        return ['manifest: must be a JSON object'];
+    }
+    const m = raw;
+    if (m.version !== 1) {
+        errors.push(`version: must be 1, got ${String(m.version)}`);
+    }
+    if (!isNonEmptyString(m.name)) {
+        errors.push('name: must be a non-empty string');
+    }
+    if (typeof m.specCount !== 'number' || !Number.isInteger(m.specCount) || m.specCount < 0) {
+        errors.push('specCount: must be a non-negative integer');
+    }
+    if (!Array.isArray(m.specs)) {
+        errors.push('specs: must be an array');
+    }
+    else {
+        for (let i = 0; i < m.specs.length; i++) {
+            const specErrors = validateManifestSpec(m.specs[i], i);
+            errors.push(...specErrors);
+        }
+    }
+    if (!Array.isArray(m.capabilities)) {
+        errors.push('capabilities: must be an array');
+    }
+    else if (!m.capabilities.every((c) => typeof c === 'string')) {
+        errors.push('capabilities: all items must be strings');
+    }
+    if (!isNonEmptyString(m.generatedAt)) {
+        errors.push('generatedAt: must be a non-empty string');
+    }
+    return errors;
+}
+/**
+ * Parse and validate a .well-known/planu.json manifest from a raw JSON string.
+ * Returns a DiscoveryResult with the parsed manifest or validation errors.
+ */
+export function parseManifest(source, rawJson) {
+    let parsed;
+    try {
+        parsed = JSON.parse(rawJson);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            valid: false,
+            errors: [`Failed to parse JSON: ${message}`],
+            source,
+        };
+    }
+    const errors = validateManifestShape(parsed);
+    if (errors.length > 0) {
+        return { valid: false, errors, source };
+    }
+    // Safe cast: validateManifestShape confirmed structure is correct
+    const m = parsed;
+    const manifest = {
+        version: 1,
+        name: m.name,
+        specCount: m.specCount,
+        specs: m.specs.map((s) => s),
+        capabilities: m.capabilities,
+        generatedAt: m.generatedAt,
+    };
+    return { valid: true, manifest, source };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/engine/well-known/discovery.js.map

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

package/dist/engine/well-known/index.d.ts

@@ -0,0 +1,6 @@
+export { generateManifest } from './manifest-generator.js';
+export type { ManifestGeneratorOptions } from '../../types/well-known.js';
+export { parseManifest } from './discovery.js';
+export { MANIFEST_SCHEMA_V1, KNOWN_CAPABILITIES } from './manifest-schema.js';
+export type { KnownCapability } from './manifest-schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/well-known/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/well-known/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/engine/well-known/index.js

@@ -0,0 +1,5 @@
+// engine/well-known/index.ts — SPEC-162: Barrel export for well-known engine module
+export { generateManifest } from './manifest-generator.js';
+export { parseManifest } from './discovery.js';
+export { MANIFEST_SCHEMA_V1, KNOWN_CAPABILITIES } from './manifest-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/well-known/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/well-known/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/engine/well-known/manifest-generator.d.ts

@@ -0,0 +1,7 @@
+import type { WellKnownManifest, ManifestGeneratorOptions } from '../../types/well-known.js';
+/**
+ * Generate a WellKnownManifest from a list of project specs.
+ * Filters out private/draft specs unless includePrivate is true.
+ */
+export declare function generateManifest(options: ManifestGeneratorOptions): WellKnownManifest;
+//# sourceMappingURL=manifest-generator.d.ts.map

package/dist/engine/well-known/manifest-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/well-known/manifest-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EAEjB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAiDnC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAkBrF"}