@specforge/cli 0.1.0 → 0.2.5

package/node_modules/@specforge/api-types/dist/mcp/lifecycle-envelope.d.ts

@@ -0,0 +1,18 @@
+import type { PlanningAgentResponse } from '@specforge/session-types';
+/**
+ * Wire envelope for lifecycle tools (planning today; work/review in M16–M25).
+ *
+ * Used on BOTH success and denial — the inner `agentResponse.outcome` self-discriminates,
+ * so denials ship HTTP 200 with this same shape (no separate error code). Canonical
+ * reference: docs/architecture/lifecycle-response-convention.md §"McpLifecycleEnvelope".
+ *
+ * Field-preserving by construction: it embeds the lifecycle response whole, with no
+ * allowlist, denylist, or remapping. Clients read `agentResponse.guidance` (prose) and the
+ * typed score / gate / phase / status fields directly — never parse the prose.
+ */
+export interface McpLifecycleEnvelope {
+    kind: 'lifecycle';
+    /** Verbatim echo of the lifecycle layer's PlanningAgentResponse. */
+    agentResponse: PlanningAgentResponse;
+}
+//# sourceMappingURL=lifecycle-envelope.d.ts.map

package/node_modules/@specforge/api-types/dist/mcp/lifecycle-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-envelope.d.ts","sourceRoot":"","sources":["../../src/mcp/lifecycle-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,oEAAoE;IACpE,aAAa,EAAE,qBAAqB,CAAC;CACtC"}

package/node_modules/@specforge/api-types/dist/mcp/lifecycle-envelope.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle-envelope.js.map

package/node_modules/@specforge/api-types/dist/mcp/lifecycle-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-envelope.js","sourceRoot":"","sources":["../../src/mcp/lifecycle-envelope.ts"],"names":[],"mappings":""}

package/node_modules/@specforge/api-types/dist/mcp/standard-envelope.d.ts

@@ -0,0 +1,39 @@
+import type { ErrorGuidance, ErrorGuidanceCode } from './error-guidance.js';
+/**
+ * Wire envelope for the 13 standard (non-lifecycle) tools on the ERROR path.
+ *
+ * Standard tools return their raw impl payload on success (no envelope wrap —
+ * see docs/architecture/lifecycle-response-convention.md). Only thrown errors
+ * are enveloped, with a typed `code`, a human `message`, the composer-produced
+ * `guidance`, and typed `context` extras.
+ *
+ * There is deliberately NO `LIFECYCLE_DENIED` code: lifecycle denials are a
+ * separate envelope (`McpLifecycleEnvelope`, HTTP 200), distinguished by `kind`.
+ * Clients dispatch on `kind` first.
+ */
+export interface McpStandardErrorEnvelope {
+    kind: 'standard_error';
+    /** Typed error code — shared with the error-guidance pipeline. */
+    code: ErrorGuidanceCode;
+    /** Human-readable, externally safe message. */
+    message: string;
+    /**
+     * Composed by the error-guidance pipeline (ME.4, amended by MB.17.2). `prose`
+     * is the canonical agent-facing message (same convention as lifecycle's
+     * `PlanningAgentResponse.guidance`). NON-NULL for EVERY code, including
+     * `INTERNAL` — MB.17.2 overturns the ME.4 `INTERNAL → null` convention: a bare
+     * exception still has an actionable hint (*"this failed server-side; nothing was
+     * persisted; do NOT retry identically; re-read state or hand to the human"*). The
+     * dispatcher's `normaliseError` refuses to assemble an envelope with null/empty
+     * guidance. NEVER hand-rolled at a throw site; always produced by a composer to
+     * avoid prose drift.
+     */
+    guidance: ErrorGuidance;
+    /**
+     * Typed extras that fed the composer (entity id not found, conflicting session
+     * id, failing field, …) — kept on the envelope so clients can render
+     * structured affordances alongside the prose.
+     */
+    context?: Record<string, unknown>;
+}
+//# sourceMappingURL=standard-envelope.d.ts.map

package/node_modules/@specforge/api-types/dist/mcp/standard-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-envelope.d.ts","sourceRoot":"","sources":["../../src/mcp/standard-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;IACvB,kEAAkE;IAClE,IAAI,EAAE,iBAAiB,CAAC;IACxB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,aAAa,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/node_modules/@specforge/api-types/dist/mcp/standard-envelope.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=standard-envelope.js.map

package/node_modules/@specforge/api-types/dist/mcp/standard-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-envelope.js","sourceRoot":"","sources":["../../src/mcp/standard-envelope.ts"],"names":[],"mappings":""}

package/node_modules/@specforge/api-types/dist/runtime/billing-record.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Billing entity contracts (M7.4b — relocated from @specforge/platform so the
+ * billing store interface can live in api-types alongside the other store
+ * contracts; api-types cannot import platform).
+ */
+export interface PlanDefinition {
+    planId: string;
+    name: string;
+    description?: string;
+    maxProjects: number;
+    maxActiveSpecs: number;
+    maxMembersPerProject: number | null;
+    maxApiKeys: number | null;
+    features: Record<string, boolean> | null;
+    isActive: boolean;
+    sortOrder: number;
+}
+//# sourceMappingURL=billing-record.d.ts.map

package/node_modules/@specforge/api-types/dist/runtime/billing-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-record.d.ts","sourceRoot":"","sources":["../../src/runtime/billing-record.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/node_modules/@specforge/api-types/dist/runtime/billing-record.js

@@ -0,0 +1,7 @@
+/**
+ * Billing entity contracts (M7.4b — relocated from @specforge/platform so the
+ * billing store interface can live in api-types alongside the other store
+ * contracts; api-types cannot import platform).
+ */
+export {};
+//# sourceMappingURL=billing-record.js.map

package/node_modules/@specforge/api-types/dist/runtime/billing-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-record.js","sourceRoot":"","sources":["../../src/runtime/billing-record.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/node_modules/@specforge/api-types/dist/runtime/blueprint-record.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Blueprint record types — the DB-entity shape returned by IBlueprintStore reads.
+ *
+ * Distinct from `Blueprint` in @specforge/spec-types, which is the canonical
+ * publication-schema content shape. BlueprintRecord adds db-only fields
+ * (order, status, contentS3Key, version, dates) used by the entity store.
+ */
+export declare const BLUEPRINT_CATEGORIES: readonly ["flowchart", "architecture", "state", "sequence", "erd", "mockup", "adr", "component", "deployment", "api", "algorithm", "protocol", "glossary", "design_system"];
+export type BlueprintCategory = (typeof BLUEPRINT_CATEGORIES)[number];
+export declare const BLUEPRINT_STATUSES: readonly ["draft", "review", "approved", "deprecated"];
+export type BlueprintStatus = (typeof BLUEPRINT_STATUSES)[number];
+export declare const BLUEPRINT_FORMATS: readonly ["markdown", "mermaid", "ascii", "mixed", "html", "svg", "image"];
+export type BlueprintFormat = (typeof BLUEPRINT_FORMATS)[number];
+export interface BlueprintRecord {
+    id: string;
+    specificationId: string;
+    title: string;
+    description?: string;
+    slug?: string;
+    category?: BlueprintCategory;
+    tags?: string[];
+    content?: string;
+    notes?: string;
+    contentS3Key?: string;
+    format?: BlueprintFormat;
+    order?: number;
+    status?: BlueprintStatus;
+    version?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TicketBlueprintReference {
+    id: string;
+    ticketId: string;
+    blueprintId: string;
+    context?: string;
+    section?: string;
+    createdAt: string;
+}
+//# sourceMappingURL=blueprint-record.d.ts.map

package/node_modules/@specforge/api-types/dist/runtime/blueprint-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint-record.d.ts","sourceRoot":"","sources":["../../src/runtime/blueprint-record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,oBAAoB,6KAKvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,eAAO,MAAM,kBAAkB,wDAAyD,CAAC;AACzF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,iBAAiB,4EAA6E,CAAC;AAC5G,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/node_modules/@specforge/api-types/dist/runtime/blueprint-record.js

@@ -0,0 +1,19 @@
+/**
+ * Blueprint record types — the DB-entity shape returned by IBlueprintStore reads.
+ *
+ * Distinct from `Blueprint` in @specforge/spec-types, which is the canonical
+ * publication-schema content shape. BlueprintRecord adds db-only fields
+ * (order, status, contentS3Key, version, dates) used by the entity store.
+ */
+// Const-array sources so the unions are runtime-checkable. They MUST stay in sync
+// with the SpecificationBlueprint model enums + @specforge/spec-types — the parity
+// test in @specforge/operations (which imports both) asserts that.
+export const BLUEPRINT_CATEGORIES = [
+    'flowchart', 'architecture', 'state', 'sequence', 'erd', 'mockup', 'adr',
+    'component', 'deployment', 'api',
+    // M1.5.5 additions.
+    'algorithm', 'protocol', 'glossary', 'design_system',
+];
+export const BLUEPRINT_STATUSES = ['draft', 'review', 'approved', 'deprecated'];
+export const BLUEPRINT_FORMATS = ['markdown', 'mermaid', 'ascii', 'mixed', 'html', 'svg', 'image'];
+//# sourceMappingURL=blueprint-record.js.map

package/node_modules/@specforge/api-types/dist/runtime/blueprint-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint-record.js","sourceRoot":"","sources":["../../src/runtime/blueprint-record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kFAAkF;AAClF,mFAAmF;AACnF,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK;IACxE,WAAW,EAAE,YAAY,EAAE,KAAK;IAChC,oBAAoB;IACpB,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe;CAC5C,CAAC;AAGX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAU,CAAC;AAGzF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAU,CAAC"}

package/node_modules/@specforge/api-types/dist/runtime/dependency-tree.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Dependency Tree Types
+ *
+ * Types for the pre-computed dependency tree stored on Specification records.
+ * Consumed by the M5.4 tree aggregator and the webapp UI.
+ */
+export type TreeTicketStatus = 'pending' | 'ready' | 'active' | 'done';
+export interface TreeEpic {
+    id: string;
+    epicNumber: number;
+    title: string;
+    status: string;
+    ticketIds: string[];
+}
+export interface TreeTicket {
+    id: string;
+    ticketNumber: number;
+    title: string;
+    status: TreeTicketStatus;
+    epicId: string;
+    epicNumber: number;
+    dependencies: string[];
+    blocks: string[];
+    isReady: boolean;
+    blockerCount: number;
+    unsatisfiedDeps: string[];
+    estimatedMinutes?: number;
+}
+export interface TreeSummary {
+    totalTickets: number;
+    ticketsByStatus: {
+        pending: number;
+        ready: number;
+        active: number;
+        done: number;
+    };
+    readyTickets: string[];
+    blockedTickets: string[];
+    hasCircularDeps: boolean;
+    criticalPathLength: number;
+    criticalPathMinutes: number;
+    /**
+     * Max depth of the longest incomplete (status !== 'done') blocking chain
+     * (M5.7 G9). Edge-counted: a single incomplete blocker → depth 1. Materialized
+     * onto Specification.maxBlockerDepth for query-time access without parsing the
+     * tree JSON.
+     */
+    maxBlockerDepth: number;
+}
+export interface CriticalPathNode {
+    id: string;
+    ticketNumber: number;
+    title: string;
+    estimatedMinutes: number;
+}
+export interface TreeEdge {
+    from: string;
+    to: string;
+}
+export interface TreeCycle {
+    cycle: string[];
+}
+export interface DependencyTree {
+    specificationId: string;
+    version: number;
+    generatedAt: string;
+    epics: TreeEpic[];
+    tickets: Record<string, TreeTicket>;
+    summary: TreeSummary;
+    criticalPath: CriticalPathNode[];
+    edges: TreeEdge[];
+    cycles?: TreeCycle[];
+}
+export interface GenerateTreeInput {
+    specificationId: string;
+    force?: boolean;
+}
+export interface GenerateTreeResponse {
+    specificationId: string;
+    version: number;
+    generatedAt: string;
+    summary: TreeSummary;
+    message: string;
+}
+export interface GetTreeResponse {
+    specificationId: string;
+    version: number;
+    generatedAt: string;
+    epics: TreeEpic[];
+    tickets: Record<string, TreeTicket>;
+    summary: TreeSummary;
+    criticalPath: CriticalPathNode[];
+    edges: TreeEdge[];
+}
+export declare function isValidDependencyTree(tree: unknown): tree is DependencyTree;
+//# sourceMappingURL=dependency-tree.d.ts.map

package/node_modules/@specforge/api-types/dist/runtime/dependency-tree.d.ts.map

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

package/node_modules/@specforge/api-types/dist/runtime/dependency-tree.js

@@ -0,0 +1,23 @@
+/**
+ * Dependency Tree Types
+ *
+ * Types for the pre-computed dependency tree stored on Specification records.
+ * Consumed by the M5.4 tree aggregator and the webapp UI.
+ */
+export function isValidDependencyTree(tree) {
+    if (!tree || typeof tree !== 'object') {
+        return false;
+    }
+    const t = tree;
+    return (typeof t.specificationId === 'string' &&
+        typeof t.version === 'number' &&
+        typeof t.generatedAt === 'string' &&
+        Array.isArray(t.epics) &&
+        typeof t.tickets === 'object' &&
+        t.tickets !== null &&
+        typeof t.summary === 'object' &&
+        t.summary !== null &&
+        Array.isArray(t.criticalPath) &&
+        Array.isArray(t.edges));
+}
+//# sourceMappingURL=dependency-tree.js.map

package/node_modules/@specforge/api-types/dist/runtime/dependency-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-tree.js","sourceRoot":"","sources":["../../src/runtime/dependency-tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqGH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,GAAG,IAA+B,CAAC;IAE1C,OAAO,CACL,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ;QACrC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACtB,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,CAAC,CAAC,OAAO,KAAK,IAAI;QAClB,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,CAAC,CAAC,OAAO,KAAK,IAAI;QAClB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CACvB,CAAC;AACJ,CAAC"}

package/node_modules/@specforge/api-types/dist/runtime/epic-record.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Epic record types — the DB-entity shape returned by IEpicStore reads.
+ *
+ * Aligned with canonical Epic (`@specforge/spec-types` post-ME.0-1):
+ * - canonical fields preserved: id, specificationId, title, description, objective,
+ *   order, architecture, scope, goals, acceptanceCriteria, validationCommands,
+ *   apiContracts, sharedPatterns, fileStructures, requirementsCovered, nfrsCovered,
+ *   goalsCovered, category, fieldDeclarations
+ * - system fields: epicNumber, status, planningType, progress, 4-state counters,
+ *   estimatedMinutes, readiness, tags, createdAt, updatedAt
+ */
+export type EpicCategory = 'foundation' | 'functional' | 'non_functional' | 'verification';
+export type EpicPlanningType = 'planning' | 'on_flight';
+export interface LookupEpicResult {
+    id: string;
+    epicNumber: number;
+    title: string;
+    status: string;
+    ticketCount: number;
+    completedTicketCount?: number;
+    pendingTicketCount?: number;
+    readyTicketCount?: number;
+    activeTicketCount?: number;
+    /** M15.5a status bucket — rolled up to Spec.blockedTicketCount (M20.3). */
+    blockedTicketCount?: number;
+    estimatedMinutes?: number | null;
+    /** G5 (M20.3) — Σ ticket.acceptanceCriteriaCount; rolled up to Spec. */
+    totalAcceptanceCriteriaCount?: number;
+    /** G5 (M20.3) — Σ ticket.validatedCriteriaCount; rolled up to Spec. */
+    validatedAcceptanceCriteriaCount?: number;
+    /** G6 (M20.3) — Σ ticket.actualMinutes; rolled up to Spec. */
+    totalActualMinutes?: number;
+    progress?: number;
+    globalReadinessScore?: number | null;
+    globalReadinessLevel?: string | null;
+}
+/**
+ * Object shapes stored in the `Epic.goals` / `Epic.acceptanceCriteria` a.json()
+ * columns (canonical GoalSchema / AcceptanceCriterionSchema in @specforge/spec-types).
+ * They are object[], NOT string[].
+ */
+export interface EpicGoal {
+    id?: string;
+    title: string;
+    description: string;
+    type?: 'business' | 'technical' | 'user' | 'operational';
+    successCriteria?: string[];
+    kpi?: string;
+}
+export interface EpicAcceptanceCriterion {
+    id?: string;
+    given: string;
+    when: string;
+    then: string;
+    order?: number;
+}
+export interface EpicFull {
+    id: string;
+    specificationId: string;
+    epicNumber: number;
+    title: string;
+    description: string;
+    objective: string;
+    order: number;
+    status: string;
+    planningType?: EpicPlanningType;
+    progress: number;
+    architecture?: string;
+    scope?: string;
+    goals?: EpicGoal[];
+    acceptanceCriteria?: EpicAcceptanceCriterion[];
+    validationCommands?: string[];
+    apiContracts?: unknown;
+    sharedPatterns?: string;
+    fileStructures?: string[];
+    requirementsCovered?: string[];
+    nfrsCovered?: string[];
+    goalsCovered?: string[];
+    category?: EpicCategory;
+    fieldDeclarations?: string;
+    ticketCount: number;
+    completedTicketCount: number;
+    pendingTicketCount: number;
+    readyTicketCount: number;
+    activeTicketCount: number;
+    estimatedMinutes?: number;
+    implementationTicketCount?: number;
+    verificationTicketCount?: number;
+    tags?: string[];
+    readinessScore?: number;
+    readinessLevel?: string;
+    globalReadinessScore?: number | null;
+    globalReadinessLevel?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EpicCommit {
+    id: string;
+    epicId: string;
+    sha: string;
+    shortSha: string | null;
+    message: string | null;
+    author: string | null;
+    url: string | null;
+    linkedAt: string;
+    metadata?: string;
+}
+export interface EpicForValidation {
+    id: string;
+    title: string;
+    ticketCount: number | null;
+    pendingTicketCount: number | null;
+    readyTicketCount: number | null;
+    activeTicketCount: number | null;
+    completedTicketCount: number | null;
+}
+//# sourceMappingURL=epic-record.d.ts.map

package/node_modules/@specforge/api-types/dist/runtime/epic-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-record.d.ts","sourceRoot":"","sources":["../../src/runtime/epic-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,cAAc,CAAC;AAGnB,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,WAAW,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IAIpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,wEAAwE;IACxE,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,uEAAuE;IACvE,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,uBAAuB;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IAEjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC/C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC"}

package/node_modules/@specforge/api-types/dist/runtime/epic-record.js

@@ -0,0 +1,13 @@
+/**
+ * Epic record types — the DB-entity shape returned by IEpicStore reads.
+ *
+ * Aligned with canonical Epic (`@specforge/spec-types` post-ME.0-1):
+ * - canonical fields preserved: id, specificationId, title, description, objective,
+ *   order, architecture, scope, goals, acceptanceCriteria, validationCommands,
+ *   apiContracts, sharedPatterns, fileStructures, requirementsCovered, nfrsCovered,
+ *   goalsCovered, category, fieldDeclarations
+ * - system fields: epicNumber, status, planningType, progress, 4-state counters,
+ *   estimatedMinutes, readiness, tags, createdAt, updatedAt
+ */
+export {};
+//# sourceMappingURL=epic-record.js.map

package/node_modules/@specforge/api-types/dist/runtime/epic-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-record.js","sourceRoot":"","sources":["../../src/runtime/epic-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/node_modules/@specforge/api-types/dist/runtime/feedback-record.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Feedback entity contracts (M7.4b — relocated from @specforge/platform so the
+ * feedback store interface can live in api-types alongside the other store
+ * contracts; api-types cannot import platform).
+ */
+export type FeedbackSource = 'mcp' | 'cli' | 'web';
+export type FeedbackCategory = 'bug' | 'feature_request' | 'usability' | 'documentation' | 'performance';
+export type FeedbackSeverity = 'critical' | 'high' | 'medium' | 'low';
+export interface FeedbackRecord {
+    id: string;
+    category: FeedbackCategory;
+    summary: string;
+    severity: FeedbackSeverity;
+    source: FeedbackSource;
+    tool?: string;
+    toolOperation?: string;
+    details?: string;
+    expected?: string;
+    actual?: string;
+    errorMessage?: string;
+    ticketId?: string;
+    userId: string;
+    userEmail?: string;
+    createdAt: string;
+    updatedAt?: string;
+}
+//# sourceMappingURL=feedback-record.d.ts.map

package/node_modules/@specforge/api-types/dist/runtime/feedback-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-record.d.ts","sourceRoot":"","sources":["../../src/runtime/feedback-record.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AACnD,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,iBAAiB,GACjB,WAAW,GACX,eAAe,GACf,aAAa,CAAC;AAClB,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/node_modules/@specforge/api-types/dist/runtime/feedback-record.js

@@ -0,0 +1,7 @@
+/**
+ * Feedback entity contracts (M7.4b — relocated from @specforge/platform so the
+ * feedback store interface can live in api-types alongside the other store
+ * contracts; api-types cannot import platform).
+ */
+export {};
+//# sourceMappingURL=feedback-record.js.map

package/node_modules/@specforge/api-types/dist/runtime/feedback-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-record.js","sourceRoot":"","sources":["../../src/runtime/feedback-record.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/node_modules/@specforge/api-types/dist/runtime/fields.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Field Selection Types
+ *
+ * Selective field retrieval for list operations.
+ */
+export interface FieldSelectionInput {
+    fields?: string[];
+}
+export interface FieldSelectionWarning {
+    invalidFields?: string[];
+}
+export interface ListResponse<T> {
+    items: T[];
+    warnings?: FieldSelectionWarning;
+    nextToken?: string;
+}
+export declare const TICKET_FIELDS: readonly ["id", "epicId", "ticketNumber", "title", "description", "status", "ticketType", "complexity", "estimatedMinutes", "planningType", "acceptanceCriteria", "codeReferences", "typeReferences", "qualityGates", "testCommands", "coverageTarget", "notes", "fieldDeclarations", "readinessScore", "readinessLevel", "tags", "progress", "order", "createdAt", "updatedAt"];
+export declare const EPIC_FIELDS: readonly ["id", "specificationId", "epicNumber", "title", "description", "objective", "order", "status", "planningType", "progress", "category", "architecture", "scope", "goals", "acceptanceCriteria", "validationCommands", "apiContracts", "sharedPatterns", "fileStructures", "requirementsCovered", "nfrsCovered", "goalsCovered", "fieldDeclarations", "ticketCount", "completedTicketCount", "pendingTicketCount", "readyTicketCount", "activeTicketCount", "estimatedMinutes", "tags", "readinessScore", "readinessLevel", "globalReadinessScore", "globalReadinessLevel", "createdAt", "updatedAt"];
+export declare const SPECIFICATION_FIELDS: readonly ["id", "projectId", "specificationTypeId", "schemaVersion", "title", "description", "background", "status", "progress", "goals", "requirements", "nonFunctionalRequirements", "acceptanceCriteria", "guardrails", "techStack", "architecture", "folderStructures", "scope", "sharedPatterns", "epicTargets", "fieldDeclarations", "epicCount", "completedEpicCount", "todoEpicCount", "inProgressEpicCount", "ticketCount", "completedTicketCount", "pendingTicketCount", "readyTicketCount", "activeTicketCount", "estimatedMinutes", "tags", "blueprints", "readinessScore", "readinessLevel", "globalReadinessScore", "globalReadinessLevel", "createdAt", "updatedAt", "dependencyTree", "dependencyTreeUpdatedAt", "dependencyTreeVersion"];
+export type TicketField = (typeof TICKET_FIELDS)[number];
+export type EpicField = (typeof EPIC_FIELDS)[number];
+export type SpecificationField = (typeof SPECIFICATION_FIELDS)[number];
+export declare function selectFields<T extends object>(items: T[], requestedFields: string[] | undefined, validFields: readonly string[]): {
+    items: Partial<T>[];
+    warnings?: FieldSelectionWarning;
+};
+export declare function validateFieldSelection(fields: unknown, validFields: readonly string[]): {
+    valid: string[];
+    invalid: string[];
+};
+//# sourceMappingURL=fields.d.ts.map

package/node_modules/@specforge/api-types/dist/runtime/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/runtime/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,kXA0BhB,CAAC;AAEX,eAAO,MAAM,WAAW,+kBAqCd,CAAC;AAEX,eAAO,MAAM,oBAAoB,2tBA2CvB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,CAAC,EAAE,EACV,eAAe,EAAE,MAAM,EAAE,GAAG,SAAS,EACrC,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B;IAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAA;CAAE,CAgC3D;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAkBxC"}