empirical-sdd 0.20.0

package/dist/core.d.ts

@@ -0,0 +1,54 @@
+import { ProjectStore } from "./storage.js";
+import { type ActionPacket, type AdoptionOptions, type ArchiveResult, type CapabilitySummary, type CompletionInput, type Criterion, type ExplainReport, type ExplorationPacket, type FeatureStartResult, type FeatureStartOptions, type InitOptions, type IntegrationReport, type ProjectConfig, type ProjectPolicy, type ProjectConfigurationInput, type StartOptions, type ValidationReport, type Workflow, type WorkflowState, type WorktreeCreateInput, type WorktreeHandoff, type WorktreeProposal } from "./types.js";
+export declare class EmpiricalProject {
+    store: ProjectStore;
+    private readonly readOnly;
+    private constructor();
+    static open(start?: string, options?: {
+        migrate?: boolean;
+    }): Promise<EmpiricalProject>;
+    static openReadOnly(start?: string): Promise<EmpiricalProject>;
+    static initialize(root?: string, options?: InitOptions): Promise<{
+        project: EmpiricalProject;
+        state: WorkflowState;
+        integrations: IntegrationReport;
+    }>;
+    static adopt(root?: string, options?: AdoptionOptions): Promise<{
+        project: EmpiricalProject;
+        state: WorkflowState;
+        integrations: IntegrationReport;
+    }>;
+    status(): Promise<WorkflowState>;
+    config(): Promise<ProjectConfig>;
+    configure(input: ProjectConfigurationInput): Promise<ProjectConfig>;
+    policy(): Promise<ProjectPolicy>;
+    explore(problem: string): Promise<ExplorationPacket>;
+    capabilities(): Promise<CapabilitySummary[]>;
+    capability(name: string): Promise<string | null>;
+    start(request: string, options?: StartOptions): Promise<FeatureStartResult>;
+    fast(request: string, options?: FeatureStartOptions): Promise<FeatureStartResult>;
+    complex(request: string, options?: FeatureStartOptions): Promise<FeatureStartResult>;
+    loop(): Promise<ActionPacket>;
+    private begin;
+    proposeWorktree(request: string, workflow: Workflow, overrides?: {
+        changeType?: "feature" | "fix" | "chore";
+        feature?: string;
+        branch?: string;
+        path?: string;
+        base?: string;
+    }): Promise<WorktreeProposal>;
+    createWorktree(input: WorktreeCreateInput): Promise<WorktreeHandoff>;
+    explain(): Promise<ExplainReport>;
+    next(): Promise<ActionPacket>;
+    complete(input: CompletionInput): Promise<ActionPacket>;
+    archive(expectedRevision: number, actor?: string): Promise<ArchiveResult>;
+    retry(expectedRevision: number, actor?: string): Promise<ActionPacket>;
+    verify(): Promise<ValidationReport>;
+    integrations(): Promise<IntegrationReport>;
+    migrate(): Promise<Record<string, unknown>>;
+    doctor(): Promise<Record<string, unknown>>;
+    private validatePhasePass;
+    private assertCapabilityDeltasUnchanged;
+    private packet;
+}
+export declare function parseCriteria(markdown: string): Criterion[];

package/dist/decisions.d.ts

@@ -0,0 +1,7 @@
+import { type ProjectStore } from "./storage.js";
+import type { DecisionSummary, DecisionValidationReport } from "./types.js";
+export declare function decisionPath(store: ProjectStore, feature: string): string;
+export declare function createDecisionTemplate(store: ProjectStore, feature: string): Promise<void>;
+export declare function validateDecisions(store: ProjectStore, feature: string, requireAccepted?: boolean): Promise<DecisionValidationReport>;
+export declare function parseDecisions(markdown: string, requireAccepted?: boolean): DecisionValidationReport;
+export declare function requireValidDecisions(store: ProjectStore, feature: string): Promise<DecisionSummary[]>;

package/dist/discovery.d.ts

@@ -0,0 +1,47 @@
+export declare const DISCOVERY_SCHEMA_VERSION: 1;
+export type DiscoveryPassId = "problem" | "outcome" | "boundaries" | "risks" | "verification";
+export type DiscoveryStatus = "draft" | "approved" | "started";
+export type DiscoveryWorkflow = "fast" | "complex";
+export interface SocraticQuestion {
+    pass: DiscoveryPassId;
+    title: string;
+    question: string;
+}
+export interface SocraticAnswer {
+    pass: DiscoveryPassId;
+    title: string;
+    question: string;
+    answer: string;
+    followUp: {
+        question: string;
+        answer: string;
+    } | null;
+}
+export interface DiscoveryRecord {
+    schemaVersion: typeof DISCOVERY_SCHEMA_VERSION;
+    id: string;
+    problem: string;
+    status: DiscoveryStatus;
+    answers: SocraticAnswer[];
+    refinedRequest: string | null;
+    approvedAt: string | null;
+    workflow: DiscoveryWorkflow | null;
+    handoff: {
+        feature: string;
+        revision: number;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DiscoveryPaths {
+    directory: string;
+    json: string;
+    markdown: string;
+}
+export declare function createDiscoveryRecord(problem: string, now?: Date): DiscoveryRecord;
+export declare function socraticQuestions(problem: string, priorContext?: string): SocraticQuestion[];
+export declare function materialFollowUp(problem: string, question: SocraticQuestion, answer: string): string | null;
+export declare function buildRefinedRequest(problem: string, answers: SocraticAnswer[]): string;
+export declare function recommendWorkflow(problem: string, answers: SocraticAnswer[]): DiscoveryWorkflow;
+export declare function saveDiscovery(root: string, record: DiscoveryRecord): Promise<DiscoveryPaths>;
+export declare function renderDiscoveryMarkdown(record: DiscoveryRecord): string;

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class EmpiricalError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(code: string, message: string, details?: unknown);
+}
+export declare function asErrorMessage(error: unknown): string;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { EmpiricalProject, parseCriteria } from "./core.js";
+export { EmpiricalError } from "./errors.js";
+export { installGlobalAgentSkills, installProjectIntegrations } from "./integrations.js";
+export { ProjectStore, discoverProject } from "./storage.js";
+export { capabilityDeltaDigest, listCapabilities, loadCapabilityDeltas, parseCapabilityDelta, planCapabilityArchive, validateFeatureDeltas, } from "./specifications.js";
+export * from "./types.js";