@zigrivers/scaffold 2.1.0

package/dist/types/errors.d.ts

@@ -0,0 +1,24 @@
+import type { ExitCode } from './enums.js';
+/** Structured error with code, exit code, and recovery hint. */
+export interface ScaffoldError {
+    /** Machine-readable error code (e.g., 'CONFIG_MISSING'). */
+    code: string;
+    /** Human-readable message. */
+    message: string;
+    /** Process exit code. */
+    exitCode: ExitCode;
+    /** Suggested fix. */
+    recovery?: string;
+    /** Context variables (file, line, value, etc.). */
+    context?: Record<string, string | number | undefined>;
+}
+/** Non-fatal warning (same shape as error but never causes non-zero exit). */
+export interface ScaffoldWarning {
+    /** Machine-readable warning code (e.g., 'CONFIG_UNKNOWN_FIELD'). */
+    code: string;
+    /** Human-readable message. */
+    message: string;
+    /** Context variables. */
+    context?: Record<string, string | number | undefined>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD"}

package/dist/types/errors.js

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

package/dist/types/errors.js.map

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

package/dist/types/frontmatter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Parsed YAML frontmatter from a meta-prompt .md file.
+ * See frontmatter-schema.md (authoritative source).
+ * Note: kebab-case YAML keys are converted to camelCase on parse.
+ */
+export interface MetaPromptFrontmatter {
+    /** Step identifier matching the filename stem. Kebab-case pattern ^[a-z][a-z0-9-]*$ */
+    name: string;
+    /** One-line purpose. Max 200 chars. */
+    description: string;
+    /**
+     * Pipeline phase: 'pre' | 'modeling' | 'decisions' | 'architecture' |
+     * 'specification' | 'planning' | 'quality' | 'validation' | 'finalization'
+     */
+    phase: string;
+    /** Unique position 1-36. Primary tiebreaker in topological sort. */
+    order: number;
+    /** Step slugs that must complete before this step can run. */
+    dependencies: string[];
+    /** Artifact paths this step produces (relative to project root). */
+    outputs: string[];
+    /** When 'if-needed', step is conditionally evaluated during init. */
+    conditional: 'if-needed' | null;
+    /** Knowledge base entry names to load during assembly. */
+    knowledgeBase: string[];
+    /** Cross-cutting artifact references beyond the dependency chain. */
+    reads: string[];
+    [key: string]: unknown;
+}
+/** A loaded meta-prompt file with parsed frontmatter and body. */
+export interface MetaPromptFile {
+    /** The filename stem (matches frontmatter name). */
+    stepName: string;
+    /** Absolute file path. */
+    filePath: string;
+    /** Validated frontmatter. */
+    frontmatter: MetaPromptFrontmatter;
+    /** Raw markdown body (everything after closing ---). */
+    body: string;
+    /** Parsed level-2 heading sections from the body. */
+    sections: Record<string, string>;
+}
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/types/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/types/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,qEAAqE;IACrE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,qEAAqE;IACrE,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,WAAW,EAAE,qBAAqB,CAAA;IAClC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC"}

package/dist/types/frontmatter.js

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

package/dist/types/frontmatter.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+export * from './enums.js';
+export * from './config.js';
+export * from './state.js';
+export * from './frontmatter.js';
+export * from './assembly.js';
+export * from './dependency.js';
+export * from './decision.js';
+export * from './lock.js';
+export * from './cli.js';
+export * from './adapter.js';
+export * from './wizard.js';
+export * from './errors.js';
+export * from './claude-md.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,14 @@
+export * from './enums.js';
+export * from './config.js';
+export * from './state.js';
+export * from './frontmatter.js';
+export * from './assembly.js';
+export * from './dependency.js';
+export * from './decision.js';
+export * from './lock.js';
+export * from './cli.js';
+export * from './adapter.js';
+export * from './wizard.js';
+export * from './errors.js';
+export * from './claude-md.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA"}

package/dist/types/lock.d.ts

@@ -0,0 +1,10 @@
+export type LockableCommand = 'run' | 'skip' | 'init' | 'reset' | 'adopt';
+export interface LockFile {
+    holder: string;
+    prompt?: string;
+    pid: number;
+    started: string;
+    processStartedAt: string;
+    command: LockableCommand;
+}
+//# sourceMappingURL=lock.d.ts.map

package/dist/types/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/types/lock.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAEzE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,eAAe,CAAA;CACzB"}

package/dist/types/lock.js

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

package/dist/types/lock.js.map

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

package/dist/types/state.d.ts

@@ -0,0 +1,49 @@
+import type { StepStatus, StepSource, DepthLevel, MethodologyName } from './enums.js';
+/** A single step's state entry in state.json. */
+export interface StepStateEntry {
+    status: StepStatus;
+    source: StepSource;
+    at?: string;
+    produces?: string[];
+    artifacts_verified?: boolean;
+    completed_by?: string;
+    reason?: string;
+    depth?: DepthLevel;
+}
+/**
+ * In-progress execution record. Non-null = either active or crashed.
+ * See state-json-schema.md InProgressRecord.
+ */
+export interface InProgressRecord {
+    step: string;
+    started: string;
+    partial_artifacts: string[];
+    actor: string;
+}
+/**
+ * User-added custom step. Phase 2 — reserved as empty array in Phase 1.
+ * See state-json-schema.md ExtraStepEntry.
+ */
+export interface ExtraStepEntry {
+    slug: string;
+    path: string;
+    'depends-on'?: string[];
+    phase?: string;
+}
+/**
+ * Complete pipeline state file (.scaffold/state.json).
+ * See state-json-schema.md.
+ */
+export interface PipelineState {
+    'schema-version': 1;
+    'scaffold-version': string;
+    init_methodology: MethodologyName;
+    config_methodology: MethodologyName;
+    'init-mode': 'greenfield' | 'brownfield' | 'v1-migration';
+    created: string;
+    in_progress: InProgressRecord | null;
+    steps: Record<string, StepStateEntry>;
+    next_eligible: string[];
+    'extra-steps': ExtraStepEntry[];
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/types/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAErF,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,UAAU,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,CAAC,CAAA;IACnB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gBAAgB,EAAE,eAAe,CAAA;IACjC,kBAAkB,EAAE,eAAe,CAAA;IACnC,WAAW,EAAE,YAAY,GAAG,YAAY,GAAG,cAAc,CAAA;IACzD,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACrC,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,aAAa,EAAE,cAAc,EAAE,CAAA;CAChC"}

package/dist/types/state.js

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

package/dist/types/state.js.map

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

package/dist/types/wizard.d.ts

@@ -0,0 +1,14 @@
+import type { MethodologyName } from './enums.js';
+export interface WizardAnswers {
+    projectName: string;
+    methodology: MethodologyName;
+    platforms: Array<'claude-code' | 'codex'>;
+    projectPlatforms?: Array<'web' | 'mobile' | 'desktop'>;
+}
+export interface DetectionResult {
+    hasExistingCode: boolean;
+    hasScaffoldConfig: boolean;
+    hasV1Config: boolean;
+    suggestedMode: 'greenfield' | 'brownfield' | 'v1-migration';
+}
+//# sourceMappingURL=wizard.d.ts.map

package/dist/types/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/types/wizard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,eAAe,CAAA;IAC5B,SAAS,EAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,CAAA;IACzC,gBAAgB,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,OAAO,CAAA;IACxB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,YAAY,GAAG,YAAY,GAAG,cAAc,CAAA;CAC5D"}

package/dist/types/wizard.js

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

package/dist/types/wizard.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,42 @@
+/** Structured scaffold error. */
+export interface ScaffoldError {
+    code: string;
+    message: string;
+    exitCode: number;
+    recovery?: string;
+    context?: Record<string, string | number | undefined>;
+}
+/** Non-fatal warning (never causes non-zero exit). */
+export interface ScaffoldWarning {
+    code: string;
+    message: string;
+    context?: Record<string, string | number | undefined>;
+}
+export declare function configMissing(configPath: string): ScaffoldError;
+export declare function configEmpty(configPath: string): ScaffoldError;
+export declare function configParseError(configPath: string, detail: string): ScaffoldError;
+export declare function configNotObject(configPath: string): ScaffoldError;
+export declare function configUnknownField(field: string, configPath: string): ScaffoldWarning;
+export declare function fieldMissing(field: string, file: string): ScaffoldError;
+export declare function fieldWrongType(field: string, expected: string, actual: string, file: string): ScaffoldError;
+export declare function fieldEmptyValue(field: string, file: string): ScaffoldError;
+export declare function fieldInvalidDepth(value: unknown, file: string): ScaffoldError;
+export declare function fieldInvalidMethodology(value: string, suggestion: string | null, file: string): ScaffoldError;
+export declare function frontmatterMissing(file: string): ScaffoldError;
+export declare function frontmatterUnclosed(file: string): ScaffoldError;
+export declare function frontmatterYamlError(file: string, detail: string): ScaffoldError;
+export declare function frontmatterNameInvalid(name: string, file: string): ScaffoldError;
+export declare function frontmatterUnknownField(field: string, file: string): ScaffoldWarning;
+export declare function stateSchemaVersion(expected: number, actual: number, file: string): ScaffoldError;
+export declare function stateMissing(file: string): ScaffoldError;
+export declare function stateParseError(file: string, detail: string): ScaffoldError;
+export declare function psmAlreadyInProgress(step: string, current: string): ScaffoldError;
+export declare function lockHeld(holder: string, pid: number, command: string): ScaffoldError;
+export declare function lockWriteFailed(file: string, detail: string): ScaffoldError;
+export declare function lockStaleCleared(holder: string, pid: number): ScaffoldWarning;
+export declare function decisionParseError(file: string, line: number, detail: string): ScaffoldError;
+export declare function presetMissing(presetName: string, file: string): ScaffoldError;
+export declare function presetParseError(file: string, detail: string): ScaffoldError;
+export declare function presetInvalidStep(step: string, preset: string): ScaffoldError;
+export declare function presetMissingStep(step: string, preset: string): ScaffoldWarning;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACtD;AAID,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAQ/D;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAQ7D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAQlF;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAQjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAMrF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAO3G;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAO1E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQ7E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAW7G;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAO9D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAO/D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAOhF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQhF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAMpF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQhG;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAQxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAQ3E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAQjF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAQpF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAO3E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAM7E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAO5F;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQ7E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAO5E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAO7E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAM/E"}

package/dist/utils/errors.js

@@ -0,0 +1,232 @@
+// src/utils/errors.ts
+// --- Error factories ---
+export function configMissing(configPath) {
+    return {
+        code: 'CONFIG_MISSING',
+        message: `Config file not found at ${configPath}`,
+        exitCode: 1,
+        recovery: 'Run "scaffold init" to create a project configuration',
+        context: { file: configPath },
+    };
+}
+export function configEmpty(configPath) {
+    return {
+        code: 'CONFIG_EMPTY',
+        message: `Config file is empty: ${configPath}`,
+        exitCode: 1,
+        recovery: 'Run "scaffold init" to create a valid configuration',
+        context: { file: configPath },
+    };
+}
+export function configParseError(configPath, detail) {
+    return {
+        code: 'CONFIG_PARSE_ERROR',
+        message: `Failed to parse config file: ${detail}`,
+        exitCode: 1,
+        recovery: 'Check the YAML syntax in .scaffold/config.yml',
+        context: { file: configPath, detail },
+    };
+}
+export function configNotObject(configPath) {
+    return {
+        code: 'CONFIG_NOT_OBJECT',
+        message: 'Config file must contain a YAML object, not a scalar or array',
+        exitCode: 1,
+        recovery: 'Ensure .scaffold/config.yml contains a valid YAML mapping',
+        context: { file: configPath },
+    };
+}
+export function configUnknownField(field, configPath) {
+    return {
+        code: 'CONFIG_UNKNOWN_FIELD',
+        message: `Unknown field "${field}" in config file`,
+        context: { file: configPath, field },
+    };
+}
+export function fieldMissing(field, file) {
+    return {
+        code: 'FIELD_MISSING',
+        message: `Required field "${field}" is missing`,
+        exitCode: 1,
+        recovery: `Add "${field}" to ${file}`,
+        context: { file, field },
+    };
+}
+export function fieldWrongType(field, expected, actual, file) {
+    return {
+        code: 'FIELD_WRONG_TYPE',
+        message: `Field "${field}" must be ${expected}, got ${actual}`,
+        exitCode: 1,
+        context: { file, field, expected, actual },
+    };
+}
+export function fieldEmptyValue(field, file) {
+    return {
+        code: 'FIELD_EMPTY_VALUE',
+        message: `Field "${field}" must not be empty`,
+        exitCode: 1,
+        context: { file, field },
+    };
+}
+export function fieldInvalidDepth(value, file) {
+    return {
+        code: 'FIELD_INVALID_DEPTH',
+        message: `Depth must be an integer between 1 and 5, got ${value}`,
+        exitCode: 1,
+        recovery: 'Set depth to a value between 1 (minimal) and 5 (comprehensive)',
+        context: { file, value: String(value) },
+    };
+}
+export function fieldInvalidMethodology(value, suggestion, file) {
+    const recovery = suggestion
+        ? `Unknown methodology "${value}". Did you mean "${suggestion}"? Valid options: deep, mvp, custom`
+        : `Unknown methodology "${value}". Valid options: deep, mvp, custom`;
+    return {
+        code: 'FIELD_INVALID_METHODOLOGY',
+        message: `Unknown methodology "${value}"`,
+        exitCode: 1,
+        recovery,
+        context: { file, value },
+    };
+}
+export function frontmatterMissing(file) {
+    return {
+        code: 'FRONTMATTER_MISSING',
+        message: 'File does not start with frontmatter delimiter ---',
+        exitCode: 1,
+        context: { file },
+    };
+}
+export function frontmatterUnclosed(file) {
+    return {
+        code: 'FRONTMATTER_UNCLOSED',
+        message: 'Frontmatter is not closed (missing closing ---)',
+        exitCode: 1,
+        context: { file },
+    };
+}
+export function frontmatterYamlError(file, detail) {
+    return {
+        code: 'FRONTMATTER_YAML_ERROR',
+        message: `Invalid YAML in frontmatter: ${detail}`,
+        exitCode: 1,
+        context: { file, detail },
+    };
+}
+export function frontmatterNameInvalid(name, file) {
+    return {
+        code: 'FRONTMATTER_NAME_INVALID',
+        message: `Frontmatter "name" field must be kebab-case, got "${name}"`,
+        exitCode: 1,
+        recovery: 'Use lowercase letters, numbers, and hyphens only (e.g., "create-prd")',
+        context: { file, name },
+    };
+}
+export function frontmatterUnknownField(field, file) {
+    return {
+        code: 'FRONTMATTER_UNKNOWN_FIELD',
+        message: `Unknown frontmatter field "${field}"`,
+        context: { file, field },
+    };
+}
+export function stateSchemaVersion(expected, actual, file) {
+    return {
+        code: 'STATE_SCHEMA_VERSION',
+        message: `state.json schema version ${actual} is not supported (expected ${expected})`,
+        exitCode: 3,
+        recovery: 'Run "scaffold reset" to reinitialize state, or upgrade scaffold',
+        context: { file, expected, actual },
+    };
+}
+export function stateMissing(file) {
+    return {
+        code: 'STATE_MISSING',
+        message: `Pipeline state not found at ${file}`,
+        exitCode: 1,
+        recovery: 'Run "scaffold init" to initialize the pipeline',
+        context: { file },
+    };
+}
+export function stateParseError(file, detail) {
+    return {
+        code: 'STATE_PARSE_ERROR',
+        message: `Failed to parse state.json: ${detail}`,
+        exitCode: 3,
+        recovery: 'Run "scaffold reset" to reinitialize state',
+        context: { file, detail },
+    };
+}
+export function psmAlreadyInProgress(step, current) {
+    return {
+        code: 'PSM_ALREADY_IN_PROGRESS',
+        message: `Cannot set "${step}" to in_progress — "${current}" is already in progress`,
+        exitCode: 3,
+        recovery: 'Wait for the current step to complete or run "scaffold reset"',
+        context: { step, current },
+    };
+}
+export function lockHeld(holder, pid, command) {
+    return {
+        code: 'LOCK_HELD',
+        message: `Scaffold is already running (${command} by ${holder}, PID ${pid})`,
+        exitCode: 3,
+        recovery: 'Wait for the other scaffold process to finish, or use --force to override',
+        context: { holder, pid, command },
+    };
+}
+export function lockWriteFailed(file, detail) {
+    return {
+        code: 'LOCK_WRITE_FAILED',
+        message: `Failed to create lock file: ${detail}`,
+        exitCode: 5,
+        context: { file, detail },
+    };
+}
+export function lockStaleCleared(holder, pid) {
+    return {
+        code: 'LOCK_STALE_CLEARED',
+        message: `Cleared stale lock from ${holder} (PID ${pid} is no longer running)`,
+        context: { holder, pid },
+    };
+}
+export function decisionParseError(file, line, detail) {
+    return {
+        code: 'DECISION_PARSE_ERROR',
+        message: `Failed to parse decision entry at line ${line}: ${detail}`,
+        exitCode: 1,
+        context: { file, line, detail },
+    };
+}
+export function presetMissing(presetName, file) {
+    return {
+        code: 'PRESET_MISSING',
+        message: `Methodology preset "${presetName}" not found at ${file}`,
+        exitCode: 1,
+        recovery: 'Reinstall scaffold to restore built-in presets',
+        context: { presetName, file },
+    };
+}
+export function presetParseError(file, detail) {
+    return {
+        code: 'PRESET_PARSE_ERROR',
+        message: `Failed to parse methodology preset: ${detail}`,
+        exitCode: 1,
+        context: { file, detail },
+    };
+}
+export function presetInvalidStep(step, preset) {
+    return {
+        code: 'PRESET_INVALID_STEP',
+        message: `Preset "${preset}" references unknown step "${step}"`,
+        exitCode: 1,
+        context: { step, preset },
+    };
+}
+export function presetMissingStep(step, preset) {
+    return {
+        code: 'PRESET_MISSING_STEP',
+        message: `Step "${step}" exists in pipeline but is not listed in preset "${preset}"`,
+        context: { step, preset },
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/utils/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/utils/errors.test.ts"],"names":[],"mappings":""}

package/dist/utils/errors.test.js

@@ -0,0 +1,91 @@
+import { describe, it, expect } from 'vitest';
+import { configMissing, configUnknownField, lockHeld, fieldInvalidMethodology, psmAlreadyInProgress, configEmpty, configParseError, configNotObject, fieldMissing, fieldWrongType, fieldEmptyValue, fieldInvalidDepth, frontmatterMissing, frontmatterUnclosed, frontmatterYamlError, frontmatterNameInvalid, frontmatterUnknownField, stateSchemaVersion, stateMissing, stateParseError, lockWriteFailed, lockStaleCleared, decisionParseError, presetMissing, presetParseError, presetInvalidStep, presetMissingStep, } from './errors.js';
+describe('error factories — shape', () => {
+    it('all error objects have code, message, exitCode', () => {
+        const errors = [
+            configMissing('/path/config.yml'),
+            configEmpty('/path/config.yml'),
+            configParseError('/path/config.yml', 'bad yaml'),
+            configNotObject('/path/config.yml'),
+            fieldMissing('name', '/path/config.yml'),
+            fieldWrongType('depth', 'number', 'string', '/path'),
+            fieldEmptyValue('name', '/path'),
+            fieldInvalidDepth(0, '/path'),
+            fieldInvalidMethodology('deap', 'deep', '/path'),
+            frontmatterMissing('/path/cmd.md'),
+            frontmatterUnclosed('/path/cmd.md'),
+            frontmatterYamlError('/path/cmd.md', 'bad yaml'),
+            frontmatterNameInvalid('Bad Name', '/path/cmd.md'),
+            stateSchemaVersion(1, 2, '/path/state.json'),
+            stateMissing('/path/state.json'),
+            stateParseError('/path/state.json', 'bad json'),
+            psmAlreadyInProgress('step-b', 'step-a'),
+            lockHeld('host', 1234, 'run'),
+            lockWriteFailed('/path/lock', 'permission denied'),
+            decisionParseError('/path/decisions.md', 10, 'bad entry'),
+            presetMissing('mvp', '/path/preset.yml'),
+            presetParseError('/path/preset.yml', 'bad yaml'),
+            presetInvalidStep('unknown-step', 'mvp'),
+        ];
+        for (const err of errors) {
+            expect(err).toHaveProperty('code');
+            expect(err).toHaveProperty('message');
+            expect(err).toHaveProperty('exitCode');
+            expect(typeof err.code).toBe('string');
+            expect(typeof err.message).toBe('string');
+            expect(typeof err.exitCode).toBe('number');
+        }
+    });
+    it('all warning objects have code and message but no exitCode', () => {
+        const warnings = [
+            configUnknownField('foo', '/path'),
+            frontmatterUnknownField('bar', '/path/cmd.md'),
+            lockStaleCleared('host', 1234),
+            presetMissingStep('step-x', 'mvp'),
+        ];
+        for (const warn of warnings) {
+            expect(warn).toHaveProperty('code');
+            expect(warn).toHaveProperty('message');
+            expect(warn).not.toHaveProperty('exitCode');
+        }
+    });
+});
+describe('configMissing', () => {
+    it('returns CONFIG_MISSING with exitCode 1', () => {
+        const err = configMissing('/path/config.yml');
+        expect(err.code).toBe('CONFIG_MISSING');
+        expect(err.exitCode).toBe(1);
+    });
+});
+describe('configUnknownField', () => {
+    it('returns CONFIG_UNKNOWN_FIELD warning with no exitCode', () => {
+        const warn = configUnknownField('foo', '/path');
+        expect(warn.code).toBe('CONFIG_UNKNOWN_FIELD');
+        expect(warn['exitCode']).toBeUndefined();
+    });
+});
+describe('lockHeld', () => {
+    it('returns LOCK_HELD with exitCode 3', () => {
+        const err = lockHeld('host', 1234, 'run');
+        expect(err.code).toBe('LOCK_HELD');
+        expect(err.exitCode).toBe(3);
+    });
+});
+describe('fieldInvalidMethodology', () => {
+    it('includes "Did you mean" in recovery when suggestion is provided', () => {
+        const err = fieldInvalidMethodology('deap', 'deep', '/path');
+        expect(err.recovery).toContain('Did you mean');
+    });
+    it('does not include "Did you mean" in recovery when suggestion is null', () => {
+        const err = fieldInvalidMethodology('xyz', null, '/path');
+        expect(err.recovery).not.toContain('Did you mean');
+    });
+});
+describe('psmAlreadyInProgress', () => {
+    it('returns PSM_ALREADY_IN_PROGRESS with exitCode 3', () => {
+        const err = psmAlreadyInProgress('step-b', 'step-a');
+        expect(err.code).toBe('PSM_ALREADY_IN_PROGRESS');
+        expect(err.exitCode).toBe(3);
+    });
+});
+//# sourceMappingURL=errors.test.js.map