@planu/cli 0.44.0 → 0.45.1

package/dist/engine/spec-registry/client.js

@@ -0,0 +1,194 @@
+// engine/spec-registry/client.ts — AC-2: Registry API Client
+// HTTP client for the Planu spec registry. Uses node:https/http only (no external deps).
+import * as https from 'node:https';
+import * as http from 'node:http';
+const DEFAULT_BASE_URL = 'https://registry.planu.dev/api/v1';
+const MAX_RETRIES = 3;
+const BASE_DELAY_MS = 1000;
+/** Build a URL with query parameters from filters. */
+function buildSearchUrl(baseUrl, filters) {
+    const url = new URL(`${baseUrl}/specs`);
+    if (filters.query) {
+        url.searchParams.set('q', filters.query);
+    }
+    if (filters.stack) {
+        url.searchParams.set('stack', filters.stack);
+    }
+    if (filters.category) {
+        url.searchParams.set('category', filters.category);
+    }
+    if (filters.sort) {
+        url.searchParams.set('sort', filters.sort);
+    }
+    if (filters.page !== undefined) {
+        url.searchParams.set('page', String(filters.page));
+    }
+    if (filters.limit !== undefined) {
+        url.searchParams.set('limit', String(filters.limit));
+    }
+    if (filters.difficulty?.min !== undefined) {
+        url.searchParams.set('difficulty_min', String(filters.difficulty.min));
+    }
+    if (filters.difficulty?.max !== undefined) {
+        url.searchParams.set('difficulty_max', String(filters.difficulty.max));
+    }
+    return url.toString();
+}
+/** Choose http or https module based on URL protocol. */
+function getTransport(url) {
+    return url.startsWith('https') ? https : http;
+}
+/** Make an HTTP request with retry and exponential backoff. */
+async function request(url, options, body) {
+    let lastError;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        if (attempt > 0) {
+            const delay = BASE_DELAY_MS * Math.pow(2, attempt - 1);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+        try {
+            const result = await executeRequest(url, options, body);
+            // Don't retry client errors (4xx) except 429
+            if (result.status >= 400 && result.status < 500 && result.status !== 429) {
+                const message = tryParseErrorMessage(result.data);
+                throw new Error(`Registry API error ${result.status}: ${message}`);
+            }
+            // Retry server errors (5xx) and 429
+            if (result.status >= 500 || result.status === 429) {
+                lastError = new Error(`Registry API error ${result.status}: server error`);
+                continue;
+            }
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith('Registry API error 4')) {
+                throw error; // Don't retry 4xx
+            }
+            lastError = error instanceof Error ? error : new Error(String(error));
+        }
+    }
+    throw new Error(`Registry API request failed after ${MAX_RETRIES} attempts: ${lastError?.message ?? 'unknown error'}`);
+}
+/** Execute a single HTTP request. */
+function executeRequest(url, options, body) {
+    return new Promise((resolve, reject) => {
+        const transport = getTransport(url);
+        const req = transport.request(url, options, (res) => {
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => {
+                resolve({
+                    status: res.statusCode ?? 0,
+                    data: Buffer.concat(chunks),
+                });
+            });
+        });
+        /* v8 ignore start -- network error/timeout handlers */
+        req.on('error', (err) => {
+            reject(new Error(`Network error: ${err.message}`));
+        });
+        req.setTimeout(30_000, () => {
+            req.destroy();
+            reject(new Error('Request timed out after 30s'));
+        });
+        /* v8 ignore stop */
+        if (body) {
+            req.write(body);
+        }
+        req.end();
+    });
+}
+/** Try to parse a JSON error message from response body. */
+/* v8 ignore start -- error parsing defensive branches */
+function tryParseErrorMessage(data) {
+    try {
+        const parsed = JSON.parse(data.toString('utf-8'));
+        return parsed.message ?? parsed.error ?? data.toString('utf-8').slice(0, 200);
+    }
+    catch {
+        return data.toString('utf-8').slice(0, 200);
+    }
+}
+/* v8 ignore stop */
+/** Build common request headers. */
+function buildHeaders(token, contentType) {
+    const headers = {
+        'User-Agent': 'planu-cli',
+        Accept: 'application/json',
+    };
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    if (contentType) {
+        headers['Content-Type'] = contentType;
+    }
+    return headers;
+}
+/**
+ * Create a registry API client instance.
+ * @param token - Optional authentication token for write operations.
+ * @returns Object with methods for interacting with the registry API.
+ */
+export function createRegistryClient(token) {
+    const baseUrl = process.env.PLANU_REGISTRY_URL ?? DEFAULT_BASE_URL;
+    const options = { token, baseUrl };
+    return {
+        /** Search specs in the registry with optional filters. */
+        async searchSpecs(filters) {
+            const url = buildSearchUrl(options.baseUrl ?? DEFAULT_BASE_URL, filters);
+            const result = await request(url, {
+                method: 'GET',
+                headers: buildHeaders(options.token),
+            });
+            return JSON.parse(result.data.toString('utf-8'));
+        },
+        /** Get metadata for a specific spec by org and name. */
+        async getSpec(org, name, version) {
+            const versionSuffix = version ? `/${version}` : '';
+            const url = `${options.baseUrl}/specs/${encodeURIComponent(org)}/${encodeURIComponent(name)}${versionSuffix}`;
+            const result = await request(url, {
+                method: 'GET',
+                headers: buildHeaders(options.token),
+            });
+            return JSON.parse(result.data.toString('utf-8'));
+        },
+        /** Download a spec tarball from the registry. */
+        async downloadSpec(org, name, version) {
+            const url = `${options.baseUrl}/specs/${encodeURIComponent(org)}/${encodeURIComponent(name)}/${version}/download`;
+            const result = await request(url, {
+                method: 'GET',
+                headers: buildHeaders(options.token),
+            });
+            return result.data;
+        },
+        /** Publish a spec tarball to the registry. Requires authentication. */
+        async publishSpec(tarball, meta) {
+            if (!options.token) {
+                throw new Error('Authentication required to publish specs. Run planu login first.');
+            }
+            const payload = JSON.stringify({ tarball: tarball.toString('base64'), meta });
+            const url = `${options.baseUrl}/specs`;
+            const result = await request(url, {
+                method: 'POST',
+                headers: buildHeaders(options.token, 'application/json'),
+            }, payload);
+            return JSON.parse(result.data.toString('utf-8'));
+        },
+        /** Rate a spec in the registry. Requires authentication. */
+        async rateSpec(org, name, rating) {
+            if (!options.token) {
+                throw new Error('Authentication required to rate specs. Run planu login first.');
+            }
+            if (rating < 1 || rating > 5 || !Number.isInteger(rating)) {
+                throw new Error('Rating must be an integer between 1 and 5');
+            }
+            const url = `${options.baseUrl}/specs/${encodeURIComponent(org)}/${encodeURIComponent(name)}/rate`;
+            const payload = JSON.stringify({ rating });
+            await request(url, {
+                method: 'POST',
+                headers: buildHeaders(options.token, 'application/json'),
+            }, payload);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/engine/spec-registry/client.js.map

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

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

@@ -0,0 +1,7 @@
+export { createRegistryClient } from './client.js';
+export type { RegistryClient } from '../../types/index.js';
+export { packSpec, unpackSpec, validatePackage } from './packager.js';
+export { validateForPublish } from './validator.js';
+export { detectStack, adaptSpec } from './adapter.js';
+export { calculateCompletenessScore } from './scorer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-registry/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,7 @@
+// engine/spec-registry/index.ts — Barrel export for spec registry engine modules.
+export { createRegistryClient } from './client.js';
+export { packSpec, unpackSpec, validatePackage } from './packager.js';
+export { validateForPublish } from './validator.js';
+export { detectStack, adaptSpec } from './adapter.js';
+export { calculateCompletenessScore } from './scorer.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/spec-registry/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

package/dist/engine/spec-registry/packager.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pack a spec directory into a gzipped archive buffer.
+ * Only includes recognized spec files (spec.md, technical.md, progress.md, planu-registry.json).
+ * @param specDir - Absolute path to the spec directory.
+ * @returns Gzipped buffer containing the archived spec files.
+ */
+export declare function packSpec(specDir: string): Promise<Buffer>;
+/**
+ * Unpack a gzipped archive buffer into a target directory.
+ * Creates the target directory if it does not exist.
+ * @param tarball - Gzipped buffer to extract.
+ * @param targetDir - Absolute path to extract files into.
+ */
+export declare function unpackSpec(tarball: Buffer, targetDir: string): Promise<void>;
+/**
+ * Validate a package buffer for structural correctness and size limits.
+ * @param tarball - Gzipped buffer to validate.
+ * @returns Validation result with errors array.
+ */
+export declare function validatePackage(tarball: Buffer): Promise<{
+    valid: boolean;
+    errors: string[];
+}>;
+//# sourceMappingURL=packager.d.ts.map

package/dist/engine/spec-registry/packager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packager.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-registry/packager.ts"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B/D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BlF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0C/C"}

package/dist/engine/spec-registry/packager.js

@@ -0,0 +1,122 @@
+// engine/spec-registry/packager.ts — AC-3: Spec Package Format
+// Creates and extracts gzipped JSON archives for spec packages.
+// Format: gzip({ files: { [relativePath]: contentString } })
+import { gzip, gunzip } from 'node:zlib';
+import { promisify } from 'node:util';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+const gzipAsync = promisify(gzip);
+const gunzipAsync = promisify(gunzip);
+/** Maximum package size in bytes (500 KB). */
+const MAX_PACKAGE_SIZE = 500 * 1024;
+/** Files that may be included in a spec package. */
+const ALLOWED_FILES = ['spec.md', 'technical.md', 'progress.md', 'planu-registry.json'];
+/**
+ * Pack a spec directory into a gzipped archive buffer.
+ * Only includes recognized spec files (spec.md, technical.md, progress.md, planu-registry.json).
+ * @param specDir - Absolute path to the spec directory.
+ * @returns Gzipped buffer containing the archived spec files.
+ */
+export async function packSpec(specDir) {
+    const archive = { files: {} };
+    for (const fileName of ALLOWED_FILES) {
+        const filePath = path.join(specDir, fileName);
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            archive.files[fileName] = content;
+        }
+        catch {
+            // Optional files may not exist — skip silently
+        }
+    }
+    if (Object.keys(archive.files).length === 0) {
+        throw new Error(`No spec files found in ${specDir}. Expected at least one of: ${ALLOWED_FILES.join(', ')}`);
+    }
+    const json = JSON.stringify(archive);
+    const compressed = await gzipAsync(Buffer.from(json, 'utf-8'));
+    if (compressed.length > MAX_PACKAGE_SIZE) {
+        throw new Error(`Package size ${compressed.length} bytes exceeds limit of ${MAX_PACKAGE_SIZE} bytes (500 KB)`);
+    }
+    return compressed;
+}
+/**
+ * Unpack a gzipped archive buffer into a target directory.
+ * Creates the target directory if it does not exist.
+ * @param tarball - Gzipped buffer to extract.
+ * @param targetDir - Absolute path to extract files into.
+ */
+export async function unpackSpec(tarball, targetDir) {
+    const decompressed = await gunzipAsync(tarball);
+    const archive = JSON.parse(decompressed.toString('utf-8'));
+    if (!archive.files || typeof archive.files !== 'object') {
+        throw new Error('Invalid archive format: missing files object');
+    }
+    // Validate paths before writing anything
+    for (const filePath of Object.keys(archive.files)) {
+        assertSafePath(filePath);
+    }
+    await fs.mkdir(targetDir, { recursive: true });
+    for (const [filePath, content] of Object.entries(archive.files)) {
+        const fullPath = path.join(targetDir, filePath);
+        // Double-check resolved path stays within target
+        const resolved = path.resolve(fullPath);
+        const resolvedTarget = path.resolve(targetDir);
+        /* v8 ignore next 2 -- path traversal guard, tested separately */
+        if (!resolved.startsWith(resolvedTarget + path.sep) && resolved !== resolvedTarget) {
+            throw new Error(`Path traversal detected: ${filePath}`);
+        }
+        await fs.writeFile(fullPath, content, 'utf-8');
+    }
+}
+/**
+ * Validate a package buffer for structural correctness and size limits.
+ * @param tarball - Gzipped buffer to validate.
+ * @returns Validation result with errors array.
+ */
+export async function validatePackage(tarball) {
+    const errors = [];
+    // Check compressed size
+    if (tarball.length > MAX_PACKAGE_SIZE) {
+        errors.push(`Package size ${tarball.length} bytes exceeds limit of ${MAX_PACKAGE_SIZE} bytes`);
+    }
+    // Try to decompress and parse
+    let archive;
+    try {
+        const decompressed = await gunzipAsync(tarball);
+        archive = JSON.parse(decompressed.toString('utf-8'));
+    }
+    catch {
+        errors.push('Failed to decompress or parse package. Expected gzipped JSON.');
+        return { valid: false, errors };
+    }
+    /* v8 ignore start -- defensive guard for malformed archives */
+    if (!archive.files || typeof archive.files !== 'object') {
+        errors.push('Invalid archive format: missing "files" object');
+        return { valid: false, errors };
+    }
+    /* v8 ignore stop */
+    // Check for path traversal
+    for (const filePath of Object.keys(archive.files)) {
+        if (filePath.includes('..') || path.isAbsolute(filePath)) {
+            errors.push(`Unsafe path detected: ${filePath}`);
+        }
+    }
+    // Check required files
+    if (!archive.files['spec.md']) {
+        errors.push('Missing required file: spec.md');
+    }
+    if (!archive.files['planu-registry.json']) {
+        errors.push('Missing required file: planu-registry.json');
+    }
+    return { valid: errors.length === 0, errors };
+}
+/** Assert that a file path is safe (no traversal, not absolute). */
+function assertSafePath(filePath) {
+    if (filePath.includes('..')) {
+        throw new Error(`Path traversal detected in archive: ${filePath}`);
+    }
+    if (path.isAbsolute(filePath)) {
+        throw new Error(`Absolute path detected in archive: ${filePath}`);
+    }
+}
+//# sourceMappingURL=packager.js.map

package/dist/engine/spec-registry/packager.js.map

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

package/dist/engine/spec-registry/scorer.d.ts

@@ -0,0 +1,10 @@
+import type { ScoreBreakdown } from '../../types/index.js';
+/**
+ * Calculate a completeness score (0-100) for a spec directory.
+ * Reads spec.md and technical.md, evaluates 6 quality categories.
+ */
+export declare function calculateCompletenessScore(specDir: string): Promise<{
+    score: number;
+    breakdown: ScoreBreakdown;
+}>;
+//# sourceMappingURL=scorer.d.ts.map

package/dist/engine/spec-registry/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-registry/scorer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmJ3D;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,cAAc,CAAA;CAAE,CAAC,CAwBvD"}

package/dist/engine/spec-registry/scorer.js

@@ -0,0 +1,151 @@
+// engine/spec-registry/scorer.ts — Spec completeness scorer for SPEC-128.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function readFileOrEmpty(path) {
+    try {
+        return await readFile(path, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+/** Count lines matching `- [ ]` or `- [x]` (acceptance criteria checkboxes). */
+function scoreAcceptanceCriteria(specContent) {
+    const matches = specContent.match(/^[\s]*- \[[x ]\]/gm);
+    const count = matches?.length ?? 0;
+    if (count >= 8) {
+        return 20;
+    }
+    if (count >= 4) {
+        return 15;
+    }
+    if (count >= 1) {
+        return 10;
+    }
+    return 0;
+}
+/** Check for a risk section header and whether it has content. */
+function scoreRisks(specContent) {
+    const riskHeaderIdx = specContent.search(/^#{1,4}\s+.*(?:riesgo|risk)/im);
+    if (riskHeaderIdx === -1) {
+        return 0;
+    }
+    // Grab text after the risk header until the next header or end
+    const afterHeader = specContent.slice(riskHeaderIdx);
+    const nextHeader = afterHeader.search(/\n#{1,4}\s+/);
+    const section = nextHeader === -1 ? afterHeader : afterHeader.slice(0, nextHeader);
+    const bodyLines = section
+        .split('\n')
+        .slice(1)
+        .filter((l) => l.trim().length > 0);
+    return bodyLines.length > 0 ? 15 : 5;
+}
+/** Check for testing strategy mentions. */
+function scoreTestingStrategy(specContent, technicalContent) {
+    const combined = `${specContent}\n${technicalContent}`;
+    // Look for a dedicated testing section header
+    const hasTestSection = /^#{1,4}\s+.*(?:test|prueba)/im.test(combined);
+    if (hasTestSection) {
+        return 15;
+    }
+    // Look for inline test references
+    const testMentions = combined.match(/\b(?:test|prueba|jest|vitest|coverage)\b/gi);
+    if (testMentions && testMentions.length >= 2) {
+        return 8;
+    }
+    return 0;
+}
+/** Check for a files/archivos listing. */
+function scoreKeyFiles(specContent, technicalContent) {
+    const combined = `${specContent}\n${technicalContent}`;
+    const filesHeaderIdx = combined.search(/^#{1,4}\s+.*(?:archivos|files)/im);
+    if (filesHeaderIdx === -1) {
+        return 0;
+    }
+    const afterHeader = combined.slice(filesHeaderIdx);
+    const nextHeader = afterHeader.search(/\n#{1,4}\s+/);
+    const section = nextHeader === -1 ? afterHeader : afterHeader.slice(0, nextHeader);
+    // Count file-like entries (lines with paths or table rows with file refs)
+    const fileEntries = section.match(/[`|]\S+\.\w{1,5}[`|]|^\s*[-|]\s*\S+\.\w{1,5}/gm);
+    const count = fileEntries?.length ?? 0;
+    if (count >= 3) {
+        return 15;
+    }
+    if (count >= 1) {
+        return 8;
+    }
+    /* v8 ignore next -- files header present but no file-like entries */
+    return 0;
+}
+/** Score technical.md based on existence and length. */
+function scoreTechnicalCompleteness(technicalContent) {
+    if (!technicalContent) {
+        return 0;
+    }
+    const lines = technicalContent.split('\n');
+    const lineCount = lines.length;
+    // Check for metadata table (lines with `|`)
+    const hasMetaTable = lines.some((l) => /^\|.*\|.*\|/.test(l));
+    if (hasMetaTable && lineCount > 50) {
+        return 20;
+    }
+    if (lineCount > 50) {
+        return 15;
+    }
+    if (lineCount > 10) {
+        return 10;
+    }
+    return 5;
+}
+/** Parse YAML frontmatter and check for required fields. */
+function scoreFrontmatter(specContent) {
+    const fmMatch = /^---\r?\n([\s\S]*?)\r?\n---/.exec(specContent);
+    if (!fmMatch) {
+        return 0;
+    }
+    const fmBlock = fmMatch[1] ?? '';
+    const requiredFields = ['id', 'title', 'type', 'status', 'priority', 'difficulty'];
+    const presentCount = requiredFields.filter((field) => new RegExp(`^${field}\\s*:`, 'm').test(fmBlock)).length;
+    if (presentCount >= 6) {
+        return 15;
+    }
+    if (presentCount >= 4) {
+        return 10;
+    }
+    if (presentCount >= 2) {
+        return 5;
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Calculate a completeness score (0-100) for a spec directory.
+ * Reads spec.md and technical.md, evaluates 6 quality categories.
+ */
+export async function calculateCompletenessScore(specDir) {
+    const [specContent, technicalContent] = await Promise.all([
+        readFileOrEmpty(join(specDir, 'spec.md')),
+        readFileOrEmpty(join(specDir, 'technical.md')),
+    ]);
+    const breakdown = {
+        acceptanceCriteria: scoreAcceptanceCriteria(specContent),
+        risksDocumented: scoreRisks(specContent),
+        testingStrategy: scoreTestingStrategy(specContent, technicalContent),
+        keyFiles: scoreKeyFiles(specContent, technicalContent),
+        technicalCompleteness: scoreTechnicalCompleteness(technicalContent),
+        frontmatterFields: scoreFrontmatter(specContent),
+    };
+    const score = breakdown.acceptanceCriteria +
+        breakdown.risksDocumented +
+        breakdown.testingStrategy +
+        breakdown.keyFiles +
+        breakdown.technicalCompleteness +
+        breakdown.frontmatterFields;
+    return { score, breakdown };
+}
+//# sourceMappingURL=scorer.js.map

package/dist/engine/spec-registry/scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.js","sourceRoot":"","sources":["../../../src/engine/spec-registry/scorer.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,SAAS,uBAAuB,CAAC,WAAmB;IAClD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IACnC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,kEAAkE;AAClE,SAAS,UAAU,CAAC,WAAmB;IACrC,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC;IAC1E,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,+DAA+D;IAC/D,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACnF,MAAM,SAAS,GAAG,OAAO;SACtB,KAAK,CAAC,IAAI,CAAC;SACX,KAAK,CAAC,CAAC,CAAC;SACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEtC,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,2CAA2C;AAC3C,SAAS,oBAAoB,CAAC,WAAmB,EAAE,gBAAwB;IACzE,MAAM,QAAQ,GAAG,GAAG,WAAW,KAAK,gBAAgB,EAAE,CAAC;IAEvD,8CAA8C;IAC9C,MAAM,cAAc,GAAG,+BAA+B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,kCAAkC;IAClC,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAClF,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,0CAA0C;AAC1C,SAAS,aAAa,CAAC,WAAmB,EAAE,gBAAwB;IAClE,MAAM,QAAQ,GAAG,GAAG,WAAW,KAAK,gBAAgB,EAAE,CAAC;IAEvD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC;IAC3E,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAEnF,0EAA0E;IAC1E,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC;IAEvC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC;IACD,qEAAqE;IACrE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,wDAAwD;AACxD,SAAS,0BAA0B,CAAC,gBAAwB;IAC1D,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;IAE/B,4CAA4C;IAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,YAAY,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,4DAA4D;AAC5D,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,MAAM,OAAO,GAAG,6BAA6B,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACnD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAChD,CAAC,MAAM,CAAC;IAET,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAe;IAEf,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxD,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACzC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;KAC/C,CAAC,CAAC;IAEH,MAAM,SAAS,GAAmB;QAChC,kBAAkB,EAAE,uBAAuB,CAAC,WAAW,CAAC;QACxD,eAAe,EAAE,UAAU,CAAC,WAAW,CAAC;QACxC,eAAe,EAAE,oBAAoB,CAAC,WAAW,EAAE,gBAAgB,CAAC;QACpE,QAAQ,EAAE,aAAa,CAAC,WAAW,EAAE,gBAAgB,CAAC;QACtD,qBAAqB,EAAE,0BAA0B,CAAC,gBAAgB,CAAC;QACnE,iBAAiB,EAAE,gBAAgB,CAAC,WAAW,CAAC;KACjD,CAAC;IAEF,MAAM,KAAK,GACT,SAAS,CAAC,kBAAkB;QAC5B,SAAS,CAAC,eAAe;QACzB,SAAS,CAAC,eAAe;QACzB,SAAS,CAAC,QAAQ;QAClB,SAAS,CAAC,qBAAqB;QAC/B,SAAS,CAAC,iBAAiB,CAAC;IAE9B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC"}

package/dist/engine/spec-registry/validator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validate a spec directory for publishing to the registry.
+ * Checks file existence, frontmatter fields, manifest structure, semver format, and size limits.
+ * @param specDir - Absolute path to the spec directory to validate.
+ * @returns Validation result with detailed error messages for each failure.
+ */
+export declare function validateForPublish(specDir: string): Promise<{
+    valid: boolean;
+    errors: string[];
+}>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/engine/spec-registry/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-registry/validator.ts"],"names":[],"mappings":"AAkCA;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqB/C"}