@planu/cli 0.63.6 → 0.64.0

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"}

package/dist/engine/well-known/manifest-generator.js

@@ -0,0 +1,60 @@
+// engine/well-known/manifest-generator.ts — SPEC-162: Generate .well-known/planu.json manifest
+import { KNOWN_CAPABILITIES } from './manifest-schema.js';
+/** Private statuses excluded from the manifest unless includePrivate=true. */
+const PRIVATE_STATUSES = new Set(['private', 'draft']);
+/**
+ * Determine capabilities to declare based on the spec list.
+ * Always includes 'spec-registry' as a base capability.
+ */
+function inferCapabilities(specs) {
+    const caps = new Set(['spec-registry']);
+    const hasEstimation = specs.some((s) => s.estimation.devHours > 0);
+    if (hasEstimation) {
+        caps.add('estimation');
+    }
+    const hasChangelog = specs.some((s) => s.status === 'done');
+    if (hasChangelog) {
+        caps.add('changelog');
+    }
+    // Only emit known capabilities to avoid leaking internal state
+    return KNOWN_CAPABILITIES.filter((k) => caps.has(k));
+}
+/**
+ * Build a ManifestSpec summary from a full Spec object.
+ * Description is capped at 200 characters to keep the manifest compact.
+ */
+function toManifestSpec(spec) {
+    // Spec does not have a description field — use the title as fallback.
+    const rawDescription = spec.title;
+    const description = rawDescription.length > 200 ? rawDescription.slice(0, 197) + '...' : rawDescription;
+    return {
+        id: spec.id,
+        title: spec.title,
+        status: spec.status,
+        type: spec.type,
+        description,
+        tags: Array.isArray(spec.tags) ? spec.tags : [],
+        created: spec.createdAt.split('T')[0] ?? spec.createdAt,
+    };
+}
+/**
+ * Generate a WellKnownManifest from a list of project specs.
+ * Filters out private/draft specs unless includePrivate is true.
+ */
+export function generateManifest(options) {
+    const { projectName, specs, includePrivate } = options;
+    const filteredSpecs = includePrivate
+        ? specs
+        : specs.filter((s) => !PRIVATE_STATUSES.has(s.status));
+    const manifestSpecs = filteredSpecs.map(toManifestSpec);
+    const capabilities = inferCapabilities(filteredSpecs);
+    return {
+        version: 1,
+        name: projectName,
+        specCount: manifestSpecs.length,
+        specs: manifestSpecs,
+        capabilities,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=manifest-generator.js.map

package/dist/engine/well-known/manifest-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-generator.js","sourceRoot":"","sources":["../../../src/engine/well-known/manifest-generator.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAQ/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,8EAA8E;AAC9E,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvD;;;GAGG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,eAAe,CAAC,CAAC,CAAC;IAEhD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC5D,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxB,CAAC;IAED,+DAA+D;IAC/D,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,IAAU;IAChC,sEAAsE;IACtE,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC;IAClC,MAAM,WAAW,GACf,cAAc,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC;IAEtF,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW;QACX,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAC/C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS;KACxD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiC;IAChE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAEvD,MAAM,aAAa,GAAG,cAAc;QAClC,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzD,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAEtD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,aAAa,CAAC,MAAM;QAC/B,KAAK,EAAE,aAAa;QACpB,YAAY;QACZ,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,92 @@
+import type { KnownCapability } from '../../types/well-known.js';
+export type { KnownCapability };
+/**
+ * JSON Schema (Draft-07) describing the .well-known/planu.json manifest format v1.
+ * Published as part of Planu docs for third-party tooling compatibility.
+ * RFC 8615 .well-known URI pattern — follows OpenID Connect / OAuth conventions.
+ */
+export declare const MANIFEST_SCHEMA_V1: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "https://planu.dev/schemas/well-known-manifest-v1.json";
+    readonly title: "Planu .well-known Manifest v1";
+    readonly description: "Spec registry discovery manifest published at .well-known/planu.json";
+    readonly type: "object";
+    readonly required: readonly ["version", "name", "specCount", "specs", "capabilities", "generatedAt"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly version: {
+            readonly type: "number";
+            readonly const: 1;
+            readonly description: "Manifest schema version. Always 1 for this format.";
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 200;
+            readonly description: "Project display name.";
+        };
+        readonly specCount: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "Total number of specs included in this manifest.";
+        };
+        readonly specs: {
+            readonly type: "array";
+            readonly description: "Array of spec summaries.";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["id", "title", "status", "type", "description", "tags", "created"];
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly pattern: "^SPEC-\\d+$";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly maxLength: 300;
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly maxLength: 50;
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly maxLength: 50;
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly maxLength: 200;
+                    };
+                    readonly tags: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly maxLength: 100;
+                        };
+                    };
+                    readonly created: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                };
+            };
+        };
+        readonly capabilities: {
+            readonly type: "array";
+            readonly description: "Planu capabilities exported by this project.";
+            readonly items: {
+                readonly type: "string";
+                readonly maxLength: 100;
+            };
+        };
+        readonly generatedAt: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly description: "ISO 8601 timestamp when this manifest was generated.";
+        };
+    };
+};
+/** Known capabilities that a project can declare in its manifest. */
+export declare const KNOWN_CAPABILITIES: readonly ["spec-registry", "federation", "living-spec", "ai-analysis", "estimation", "changelog"];
+//# sourceMappingURL=manifest-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../../../src/engine/well-known/manifest-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDrB,CAAC;AAEX,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,mGAOrB,CAAC"}

package/dist/engine/well-known/manifest-schema.js

@@ -0,0 +1,70 @@
+/**
+ * JSON Schema (Draft-07) describing the .well-known/planu.json manifest format v1.
+ * Published as part of Planu docs for third-party tooling compatibility.
+ * RFC 8615 .well-known URI pattern — follows OpenID Connect / OAuth conventions.
+ */
+export const MANIFEST_SCHEMA_V1 = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    $id: 'https://planu.dev/schemas/well-known-manifest-v1.json',
+    title: 'Planu .well-known Manifest v1',
+    description: 'Spec registry discovery manifest published at .well-known/planu.json',
+    type: 'object',
+    required: ['version', 'name', 'specCount', 'specs', 'capabilities', 'generatedAt'],
+    additionalProperties: false,
+    properties: {
+        version: {
+            type: 'number',
+            const: 1,
+            description: 'Manifest schema version. Always 1 for this format.',
+        },
+        name: {
+            type: 'string',
+            minLength: 1,
+            maxLength: 200,
+            description: 'Project display name.',
+        },
+        specCount: {
+            type: 'integer',
+            minimum: 0,
+            description: 'Total number of specs included in this manifest.',
+        },
+        specs: {
+            type: 'array',
+            description: 'Array of spec summaries.',
+            items: {
+                type: 'object',
+                required: ['id', 'title', 'status', 'type', 'description', 'tags', 'created'],
+                additionalProperties: false,
+                properties: {
+                    id: { type: 'string', pattern: '^SPEC-\\d+$' },
+                    title: { type: 'string', maxLength: 300 },
+                    status: { type: 'string', maxLength: 50 },
+                    type: { type: 'string', maxLength: 50 },
+                    description: { type: 'string', maxLength: 200 },
+                    tags: { type: 'array', items: { type: 'string', maxLength: 100 } },
+                    created: { type: 'string', format: 'date' },
+                },
+            },
+        },
+        capabilities: {
+            type: 'array',
+            description: 'Planu capabilities exported by this project.',
+            items: { type: 'string', maxLength: 100 },
+        },
+        generatedAt: {
+            type: 'string',
+            format: 'date-time',
+            description: 'ISO 8601 timestamp when this manifest was generated.',
+        },
+    },
+};
+/** Known capabilities that a project can declare in its manifest. */
+export const KNOWN_CAPABILITIES = [
+    'spec-registry',
+    'federation',
+    'living-spec',
+    'ai-analysis',
+    'estimation',
+    'changelog',
+];
+//# sourceMappingURL=manifest-schema.js.map

package/dist/engine/well-known/manifest-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../../../src/engine/well-known/manifest-schema.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,yCAAyC;IAClD,GAAG,EAAE,uDAAuD;IAC5D,KAAK,EAAE,+BAA+B;IACtC,WAAW,EAAE,sEAAsE;IACnF,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,CAAC;IAClF,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,oDAAoD;SAClE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,uBAAuB;SACrC;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,kDAAkD;SAChE;QACD,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,0BAA0B;YACvC,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC;gBAC7E,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;oBAC9C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;oBACzC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE;oBACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE;oBACvC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;oBAC/C,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE;oBAClE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;iBAC5C;aACF;SACF;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,8CAA8C;YAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE;SAC1C;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,sDAAsD;SACpE;KACF;CACO,CAAC;AAEX,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe;IACf,YAAY;IACZ,aAAa;IACb,aAAa;IACb,YAAY;IACZ,WAAW;CACH,CAAC"}

package/dist/resources/spec-granular.d.ts

@@ -0,0 +1,33 @@
+import type { ListResourcesResult, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SpecUri } from '../types/index.js';
+/**
+ * Parse acceptance criteria from a spec.md string.
+ * Looks for lines matching "- [ ]" or "- [x]" patterns under "## Acceptance Criteria".
+ */
+export declare function parseAcceptanceCriteria(markdown: string): string[];
+/**
+ * Parse a spec:// URI into its components.
+ * Returns null for unrecognized patterns.
+ */
+export declare function parseSpecUri(uri: URL): SpecUri | null;
+/**
+ * Serve content for any spec:// URI.
+ */
+export declare function handleSpecGranularRead(uri: URL): Promise<ReadResourceResult>;
+export declare function listSpecGranularResources(): Promise<ListResourcesResult>;
+/**
+ * Dynamic URI template for granular spec access.
+ * Covers: spec://{projectId}/{specId}
+ *         spec://{projectId}/{specId}/technical
+ *         spec://{projectId}/{specId}/progress
+ *         spec://{projectId}/{specId}/ac/{acIndex}
+ * We use the broadest template and parse the full URI in the read callback.
+ */
+export declare const specGranularTemplate: ResourceTemplate;
+export declare const specGranularResourceDefinition: {
+    name: string;
+    description: string;
+    mimeType: string;
+};
+//# sourceMappingURL=spec-granular.d.ts.map

package/dist/resources/spec-granular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-granular.d.ts","sourceRoot":"","sources":["../../src/resources/spec-granular.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAQ,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAsEvD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBlE;AA2CD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,GAAG,IAAI,CAyCrD;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8FlF;AAMD,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAG9E;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,kBAE/B,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;CAS1C,CAAC"}