@wrongstack/sdd 0.296.3 → 0.297.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +3 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +331 -51
- package/dist/index.js.map +4 -4
- package/dist/kanban-sdd-session.d.ts +7 -0
- package/dist/kanban-sdd-session.d.ts.map +1 -0
- package/dist/sdd-board-projector.d.ts +7 -3
- package/dist/sdd-board-projector.d.ts.map +1 -1
- package/dist/sdd-board-store.d.ts +7 -6
- package/dist/sdd-board-store.d.ts.map +1 -1
- package/dist/sdd-interview-driver.d.ts +6 -4
- package/dist/sdd-interview-driver.d.ts.map +1 -1
- package/dist/sdd-lifecycle.d.ts +11 -1
- package/dist/sdd-lifecycle.d.ts.map +1 -1
- package/dist/sdd-session-types.d.ts +34 -0
- package/dist/sdd-session-types.d.ts.map +1 -0
- package/dist/spec-builder.d.ts +9 -33
- package/dist/spec-builder.d.ts.map +1 -1
- package/dist/start-sdd-run.d.ts +6 -2
- package/dist/start-sdd-run.d.ts.map +1 -1
- package/dist/task-graph-store.d.ts +11 -1
- package/dist/task-graph-store.d.ts.map +1 -1
- package/package.json +3 -3
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { type AISpecSessionPersistence } from './sdd-session-types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Project-scoped SDD interview persistence. The Kanban daemon is authoritative;
|
|
4
|
+
* an old session JSON file is imported and removed on the first successful read.
|
|
5
|
+
*/
|
|
6
|
+
export declare function createKanbanSddSessionPersistence(projectRoot: string, legacySessionPath?: string): AISpecSessionPersistence;
|
|
7
|
+
//# sourceMappingURL=kanban-sdd-session.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kanban-sdd-session.d.ts","sourceRoot":"","sources":["../src/kanban-sdd-session.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,wBAAwB,EAE9B,MAAM,wBAAwB,CAAC;AAIhC;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,EACnB,iBAAiB,CAAC,EAAE,MAAM,GACzB,wBAAwB,CAuD1B"}
|
|
@@ -16,7 +16,11 @@ import type { EventBus } from '@wrongstack/core/kernel';
|
|
|
16
16
|
import type { TaskTracker } from '@wrongstack/core/tasking';
|
|
17
17
|
import type { SecretScrubber, TaskGraph } from '@wrongstack/core/types';
|
|
18
18
|
import { type SddBoardSnapshot } from './board-types.js';
|
|
19
|
-
import type {
|
|
19
|
+
import type { SddBoardEvent } from './sdd-board-store.js';
|
|
20
|
+
export interface SddBoardPersistence {
|
|
21
|
+
saveSnapshot(snapshot: SddBoardSnapshot): Promise<void>;
|
|
22
|
+
appendEvent(runId: string, event: SddBoardEvent): Promise<void>;
|
|
23
|
+
}
|
|
20
24
|
export interface SddBoardProjectorOptions {
|
|
21
25
|
runId: string;
|
|
22
26
|
graph: TaskGraph;
|
|
@@ -24,8 +28,8 @@ export interface SddBoardProjectorOptions {
|
|
|
24
28
|
events: EventBus;
|
|
25
29
|
/** Parent session id for emitted `sdd.board.snapshot` events. */
|
|
26
30
|
sessionId?: string | (() => string | undefined) | undefined;
|
|
27
|
-
/** Persist snapshots +
|
|
28
|
-
store?:
|
|
31
|
+
/** Persist snapshots + audit events (optional — omit for in-memory only). */
|
|
32
|
+
store?: SddBoardPersistence | undefined;
|
|
29
33
|
specId?: string | undefined;
|
|
30
34
|
/** Run-level default worker model/provider/fallbacks (shown in the board header). */
|
|
31
35
|
defaultModel?: string | undefined;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sdd-board-projector.d.ts","sourceRoot":"","sources":["../src/sdd-board-projector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAGL,KAAK,gBAAgB,EAItB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"sdd-board-projector.d.ts","sourceRoot":"","sources":["../src/sdd-board-projector.ts"],"names":[],"mappings":"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"}
|
|
@@ -39,11 +39,12 @@ export interface SddBoardEvent {
|
|
|
39
39
|
payload?: unknown;
|
|
40
40
|
}
|
|
41
41
|
/**
|
|
42
|
-
*
|
|
43
|
-
* - `<runId>.json` —
|
|
42
|
+
* Legacy-compatible SDD board storage. A board (= one parallel run) may have:
|
|
43
|
+
* - `<runId>.json` — legacy snapshot imported into Kanban workflow state
|
|
44
44
|
* - `<runId>.events.jsonl`— bounded tail event log (audit / recent replay)
|
|
45
|
-
* - `<runId>.control.jsonl` —
|
|
46
|
-
* plus `_index.json
|
|
45
|
+
* - `<runId>.control.jsonl` — legacy command queue imported once by new runs
|
|
46
|
+
* plus legacy `_index.json`. Production snapshot/control authority lives in the
|
|
47
|
+
* project-scoped Kanban daemon; JSONL remains the append-only audit stream.
|
|
47
48
|
*/
|
|
48
49
|
export declare class SddBoardStore {
|
|
49
50
|
private readonly baseDir;
|
|
@@ -70,13 +71,13 @@ export declare class SddBoardStore {
|
|
|
70
71
|
loadLatestForSpec(specId: string): Promise<SddBoardSnapshot | null>;
|
|
71
72
|
/** Append one line to the board's JSONL event log (best-effort, never throws). */
|
|
72
73
|
appendEvent(runId: string, event: SddBoardEvent): Promise<void>;
|
|
73
|
-
/** Append a control command
|
|
74
|
+
/** Append a legacy control command. Production readers use Kanban IPC. */
|
|
74
75
|
appendControl(runId: string, command: {
|
|
75
76
|
ts: number;
|
|
76
77
|
type: string;
|
|
77
78
|
payload?: unknown;
|
|
78
79
|
}): Promise<void>;
|
|
79
|
-
/** Read + truncate the control queue
|
|
80
|
+
/** Read + truncate the legacy control queue for one-time migration. */
|
|
80
81
|
drainControl(runId: string): Promise<Array<{
|
|
81
82
|
ts: number;
|
|
82
83
|
type: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sdd-board-store.d.ts","sourceRoot":"","sources":["../src/sdd-board-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMzD,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,kEAAkE;IAClE,aAAa,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED
|
|
1
|
+
{"version":3,"file":"sdd-board-store.d.ts","sourceRoot":"","sources":["../src/sdd-board-store.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { TaskTracker } from '@wrongstack/core/tasking';
|
|
2
2
|
import type { TaskGraph } from '@wrongstack/core/types';
|
|
3
3
|
import { type SddBoardColumn, type SddBoardTask } from './board-types.js';
|
|
4
|
-
import { AISpecBuilder, type AISpecPhase } from './spec-builder.js';
|
|
4
|
+
import { AISpecBuilder, type AISpecPhase, type AISpecSessionPersistence } from './spec-builder.js';
|
|
5
5
|
import type { SpecStore } from './spec-store.js';
|
|
6
6
|
import type { TaskGraphStore } from './task-graph-store.js';
|
|
7
7
|
export interface SddInterviewDriverOptions {
|
|
@@ -11,6 +11,8 @@ export interface SddInterviewDriverOptions {
|
|
|
11
11
|
graphStore: TaskGraphStore;
|
|
12
12
|
/** Persist the interview session here so a reconnect can resume it. */
|
|
13
13
|
sessionPath?: string | undefined;
|
|
14
|
+
/** Durable interview session owner. Takes precedence over `sessionPath`. */
|
|
15
|
+
sessionPersistence?: AISpecSessionPersistence | undefined;
|
|
14
16
|
/** Project context string injected into the questioning prompt. */
|
|
15
17
|
projectContext?: string | undefined;
|
|
16
18
|
minQuestions?: number | undefined;
|
|
@@ -72,17 +74,17 @@ export declare class SddInterviewDriver {
|
|
|
72
74
|
private readonly maxQuestions;
|
|
73
75
|
private tracker;
|
|
74
76
|
private graph;
|
|
75
|
-
/** Set when {@link loadExisting} successfully rehydrated a session
|
|
77
|
+
/** Set when {@link loadExisting} successfully rehydrated a durable session. */
|
|
76
78
|
private resumedFromDisk;
|
|
77
79
|
constructor(opts: SddInterviewDriverOptions);
|
|
78
80
|
/** Begin a fresh interview. Returns the first AI prompt (a question kickoff). */
|
|
79
81
|
start(title: string, intent?: string): string;
|
|
80
82
|
/**
|
|
81
|
-
* Resume a previously-persisted interview
|
|
83
|
+
* Resume a previously-persisted interview. Re-hydrates the task
|
|
82
84
|
* graph too when one was already produced. Returns true if a session loaded.
|
|
83
85
|
*/
|
|
84
86
|
loadExisting(): Promise<boolean>;
|
|
85
|
-
/** Drop the
|
|
87
|
+
/** Drop the durable session (if any) and clear in-memory interview state. */
|
|
86
88
|
discard(): Promise<void>;
|
|
87
89
|
setLastAgentText(text: string): Promise<void>;
|
|
88
90
|
getLastAgentText(): string | undefined;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sdd-interview-driver.d.ts","sourceRoot":"","sources":["../src/sdd-interview-driver.ts"],"names":[],"mappings":"AAgBA,OAAO,
|
|
1
|
+
{"version":3,"file":"sdd-interview-driver.d.ts","sourceRoot":"","sources":["../src/sdd-interview-driver.ts"],"names":[],"mappings":"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"}
|
package/dist/sdd-lifecycle.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
type SddStateTransport = 'kanban' | 'legacy-file';
|
|
1
2
|
/** Force-remove every git worktree + branch a previous run left behind. */
|
|
2
3
|
export declare function cleanupSddWorktrees(projectRoot: string): Promise<{
|
|
3
4
|
removed: number;
|
|
@@ -18,6 +19,8 @@ export interface CleanupStaleSddOptions {
|
|
|
18
19
|
projectRoot: string;
|
|
19
20
|
/** Board snapshot dir (`wpaths.projectSddBoards`) — read for the liveness guard. */
|
|
20
21
|
boardsDir: string;
|
|
22
|
+
/** Durable snapshot owner. Legacy remains the default for API compatibility. */
|
|
23
|
+
stateTransport?: SddStateTransport | undefined;
|
|
21
24
|
/** A `running` board updated within this window is treated as live → skip. Default 120_000 (2 min). */
|
|
22
25
|
runningLiveMs?: number | undefined;
|
|
23
26
|
/** A `paused` board updated within this window is treated as live → skip. Default 1_800_000 (30 min). */
|
|
@@ -51,6 +54,8 @@ export interface RollbackFromDiskOptions {
|
|
|
51
54
|
boardsDir: string;
|
|
52
55
|
/** Specific run to roll back. Omit → the most recently updated board. */
|
|
53
56
|
runId?: string | undefined;
|
|
57
|
+
/** Durable snapshot owner. Legacy remains the default for API compatibility. */
|
|
58
|
+
stateTransport?: SddStateTransport | undefined;
|
|
54
59
|
}
|
|
55
60
|
/**
|
|
56
61
|
* Roll back a finished run's merged commits by reading its persisted board
|
|
@@ -84,6 +89,8 @@ export interface DestroySddProjectOptions {
|
|
|
84
89
|
revertMerged?: boolean | undefined;
|
|
85
90
|
/** Which run's merged commits to revert. Omit → the most recently updated board. */
|
|
86
91
|
runId?: string | undefined;
|
|
92
|
+
/** Durable snapshot owner. Legacy remains the default for API compatibility. */
|
|
93
|
+
stateTransport?: SddStateTransport | undefined;
|
|
87
94
|
}
|
|
88
95
|
export interface DestroySddProjectResult {
|
|
89
96
|
worktreesRemoved: number;
|
|
@@ -120,6 +127,8 @@ export interface SddLifecycleOptions {
|
|
|
120
127
|
runId?: string | undefined;
|
|
121
128
|
/** `destroy` only: also revert merged commits before wiping. */
|
|
122
129
|
revertMerged?: boolean | undefined;
|
|
130
|
+
/** Durable snapshot owner. Legacy remains the default for API compatibility. */
|
|
131
|
+
stateTransport?: SddStateTransport | undefined;
|
|
123
132
|
}
|
|
124
133
|
/** Uniform result for any lifecycle op — drives identical UI wording everywhere. */
|
|
125
134
|
export interface SddLifecycleResult {
|
|
@@ -135,7 +144,7 @@ export interface SddLifecycleResult {
|
|
|
135
144
|
reason?: string | undefined;
|
|
136
145
|
}
|
|
137
146
|
/**
|
|
138
|
-
* Apply a post-run SDD lifecycle operation from
|
|
147
|
+
* Apply a post-run SDD lifecycle operation from durable state and return a uniform result.
|
|
139
148
|
* The single entry point shared by the WebUI board handler, the TUI overlay, and
|
|
140
149
|
* the CLI `/sdd` host so every surface reports the same thing. The caller must
|
|
141
150
|
* ensure no run is active (these operate on git + on-disk state, not the live
|
|
@@ -143,4 +152,5 @@ export interface SddLifecycleResult {
|
|
|
143
152
|
* dirty tree. Never throws.
|
|
144
153
|
*/
|
|
145
154
|
export declare function applySddLifecycle(op: SddLifecycleOp, opts: SddLifecycleOptions): Promise<SddLifecycleResult>;
|
|
155
|
+
export {};
|
|
146
156
|
//# sourceMappingURL=sdd-lifecycle.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sdd-lifecycle.d.ts","sourceRoot":"","sources":["../src/sdd-lifecycle.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"sdd-lifecycle.d.ts","sourceRoot":"","sources":["../src/sdd-lifecycle.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import type { Specification } from '@wrongstack/core/types';
|
|
2
|
+
export type AISpecPhase = 'questioning' | 'spec_review' | 'implementation' | 'task_review' | 'executing' | 'done';
|
|
3
|
+
export interface CollectedAnswer {
|
|
4
|
+
question: string;
|
|
5
|
+
answer: string;
|
|
6
|
+
timestamp: number;
|
|
7
|
+
}
|
|
8
|
+
export interface AISpecSession {
|
|
9
|
+
id: string;
|
|
10
|
+
phase: AISpecPhase;
|
|
11
|
+
title: string;
|
|
12
|
+
userIntent: string;
|
|
13
|
+
projectContext: string;
|
|
14
|
+
answers: CollectedAnswer[];
|
|
15
|
+
questionCount: number;
|
|
16
|
+
spec?: Specification | undefined;
|
|
17
|
+
implementation?: string | undefined;
|
|
18
|
+
taskGraphId?: string | undefined;
|
|
19
|
+
/** Last agent message shown to the operator for reconnect continuity. */
|
|
20
|
+
lastAgentText?: string | undefined;
|
|
21
|
+
/** Most recent SDD run id started from this interview. */
|
|
22
|
+
lastRunId?: string | undefined;
|
|
23
|
+
approved: boolean;
|
|
24
|
+
createdAt: number;
|
|
25
|
+
updatedAt: number;
|
|
26
|
+
}
|
|
27
|
+
/** Durable session adapter. Production uses project-scoped Kanban IPC. */
|
|
28
|
+
export interface AISpecSessionPersistence {
|
|
29
|
+
load(): Promise<AISpecSession | null>;
|
|
30
|
+
save(session: AISpecSession): Promise<void>;
|
|
31
|
+
delete(): Promise<void>;
|
|
32
|
+
}
|
|
33
|
+
export declare function isAISpecSession(value: unknown): value is AISpecSession;
|
|
34
|
+
//# sourceMappingURL=sdd-session-types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sdd-session-types.d.ts","sourceRoot":"","sources":["../src/sdd-session-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB;IACvC,IAAI,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAWtE"}
|
package/dist/spec-builder.d.ts
CHANGED
|
@@ -1,34 +1,7 @@
|
|
|
1
1
|
import type { Specification } from '@wrongstack/core/types';
|
|
2
|
+
import { type AISpecPhase, type AISpecSession, type AISpecSessionPersistence } from './sdd-session-types.js';
|
|
2
3
|
import type { SpecStore } from './spec-store.js';
|
|
3
|
-
export type AISpecPhase
|
|
4
|
-
export interface CollectedAnswer {
|
|
5
|
-
question: string;
|
|
6
|
-
answer: string;
|
|
7
|
-
timestamp: number;
|
|
8
|
-
}
|
|
9
|
-
export interface AISpecSession {
|
|
10
|
-
id: string;
|
|
11
|
-
phase: AISpecPhase;
|
|
12
|
-
title: string;
|
|
13
|
-
userIntent: string;
|
|
14
|
-
projectContext: string;
|
|
15
|
-
answers: CollectedAnswer[];
|
|
16
|
-
questionCount: number;
|
|
17
|
-
spec?: Specification | undefined;
|
|
18
|
-
implementation?: string | undefined;
|
|
19
|
-
taskGraphId?: string | undefined;
|
|
20
|
-
/**
|
|
21
|
-
* Last agent message shown to the operator (open question or plan prose).
|
|
22
|
-
* Persisted so a reconnect/restart can re-pair the next user answer and
|
|
23
|
-
* re-render the transcript without re-running the model.
|
|
24
|
-
*/
|
|
25
|
-
lastAgentText?: string | undefined;
|
|
26
|
-
/** Most recent SDD run id started from this interview (continuity deep-link). */
|
|
27
|
-
lastRunId?: string | undefined;
|
|
28
|
-
approved: boolean;
|
|
29
|
-
createdAt: number;
|
|
30
|
-
updatedAt: number;
|
|
31
|
-
}
|
|
4
|
+
export { type AISpecPhase, type AISpecSession, type AISpecSessionPersistence, type CollectedAnswer, isAISpecSession, } from './sdd-session-types.js';
|
|
32
5
|
export interface AISpecBuilderOptions {
|
|
33
6
|
store: SpecStore;
|
|
34
7
|
/** Minimum questions the AI should ask. Default: 2 */
|
|
@@ -37,8 +10,10 @@ export interface AISpecBuilderOptions {
|
|
|
37
10
|
maxQuestions?: number | undefined;
|
|
38
11
|
/** Project context string (package.json, file structure, etc.) */
|
|
39
12
|
projectContext?: string | undefined;
|
|
40
|
-
/**
|
|
13
|
+
/** Legacy file persistence path. Production hosts provide `sessionPersistence`. */
|
|
41
14
|
sessionPath?: string | undefined;
|
|
15
|
+
/** Durable session owner. Takes precedence over `sessionPath`. */
|
|
16
|
+
sessionPersistence?: AISpecSessionPersistence | undefined;
|
|
42
17
|
}
|
|
43
18
|
/**
|
|
44
19
|
* AI-driven specification builder. Instead of static questions, this builder
|
|
@@ -51,12 +26,13 @@ export declare class AISpecBuilder {
|
|
|
51
26
|
private readonly minQuestions;
|
|
52
27
|
private readonly maxQuestions;
|
|
53
28
|
private readonly sessionPath?;
|
|
29
|
+
private readonly sessionPersistence?;
|
|
54
30
|
constructor(opts: AISpecBuilderOptions);
|
|
55
|
-
/** Save session state to
|
|
31
|
+
/** Save session state to the configured durable owner. */
|
|
56
32
|
saveSession(): Promise<void>;
|
|
57
|
-
/** Load session state from
|
|
33
|
+
/** Load session state from the configured durable owner. */
|
|
58
34
|
loadSession(): Promise<boolean>;
|
|
59
|
-
/** Delete saved session from
|
|
35
|
+
/** Delete the saved session from the configured durable owner. */
|
|
60
36
|
deleteSession(): Promise<void>;
|
|
61
37
|
/** Auto-save helper. saveSession() already handles best-effort persistence. */
|
|
62
38
|
private autoSave;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"spec-builder.d.ts","sourceRoot":"","sources":["../src/spec-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAgC,MAAM,wBAAwB,CAAC;AAG1F,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"spec-builder.d.ts","sourceRoot":"","sources":["../src/spec-builder.ts"],"names":[],"mappings":"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"}
|
package/dist/start-sdd-run.d.ts
CHANGED
|
@@ -19,7 +19,7 @@ export interface StartSddRunOptions {
|
|
|
19
19
|
sessionId?: string | (() => string | undefined) | undefined;
|
|
20
20
|
/** Per-task agent factory. Omit to run every task on the leader agent. */
|
|
21
21
|
subagentFactory?: AgentFactory | undefined;
|
|
22
|
-
/** Board snapshot/event
|
|
22
|
+
/** Board snapshot/event compatibility cache. Durable control is owned by Kanban IPC. */
|
|
23
23
|
boardStore: SddBoardStore;
|
|
24
24
|
/** Registry the run is registered with for in-process control. */
|
|
25
25
|
registry?: SddRunRegistry | undefined;
|
|
@@ -46,8 +46,12 @@ export interface StartSddRunOptions {
|
|
|
46
46
|
maxRecoveryRounds?: number | undefined;
|
|
47
47
|
/** Progress callback (e.g. CLI renderer line). */
|
|
48
48
|
onProgress?: ((p: SddProgress) => void) | undefined;
|
|
49
|
-
/**
|
|
49
|
+
/** Durable workflow-queue reconciliation interval in ms (default 500). */
|
|
50
50
|
controlDrainMs?: number | undefined;
|
|
51
|
+
/** Explicit compatibility mode for legacy file-codec tests and old hosts. */
|
|
52
|
+
controlTransport?: 'kanban' | 'legacy-file' | undefined;
|
|
53
|
+
/** Snapshot owner; defaults to Kanban IPC unless legacy control was requested. */
|
|
54
|
+
boardStateTransport?: 'kanban' | 'legacy-file' | undefined;
|
|
51
55
|
}
|
|
52
56
|
export interface SddRunHandle {
|
|
53
57
|
run: SddParallelRun;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"start-sdd-run.d.ts","sourceRoot":"","sources":["../src/start-sdd-run.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAkB,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;
|
|
1
|
+
{"version":3,"file":"start-sdd-run.d.ts","sourceRoot":"","sources":["../src/start-sdd-run.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { TaskStore } from '@wrongstack/core/tasking';
|
|
1
2
|
import type { TaskGraph } from '@wrongstack/core/types';
|
|
2
3
|
export interface TaskGraphStoreOptions {
|
|
3
4
|
/** Directory where task graph files are stored. Defaults to `.wrongstack/task-graphs`. */
|
|
@@ -16,15 +17,24 @@ export interface TaskGraphIndexEntry {
|
|
|
16
17
|
* File-backed task graph storage. Each graph is a JSON file under `baseDir/`.
|
|
17
18
|
* An index file (`_index.json`) tracks all graphs for fast listing.
|
|
18
19
|
*/
|
|
19
|
-
export declare class TaskGraphStore {
|
|
20
|
+
export declare class TaskGraphStore implements TaskStore {
|
|
20
21
|
private readonly baseDir;
|
|
21
22
|
private readonly indexPath;
|
|
23
|
+
private writeChain;
|
|
22
24
|
constructor(opts: TaskGraphStoreOptions);
|
|
23
25
|
save(graph: TaskGraph): Promise<void>;
|
|
24
26
|
load(id: string): Promise<TaskGraph | null>;
|
|
25
27
|
list(): Promise<TaskGraphIndexEntry[]>;
|
|
26
28
|
delete(id: string): Promise<boolean>;
|
|
27
29
|
exists(id: string): Promise<boolean>;
|
|
30
|
+
saveGraph(graph: TaskGraph): Promise<void>;
|
|
31
|
+
loadGraph(id: string): Promise<TaskGraph | null>;
|
|
32
|
+
listGraphs(): Promise<Array<{
|
|
33
|
+
id: string;
|
|
34
|
+
title: string;
|
|
35
|
+
updatedAt: number;
|
|
36
|
+
}>>;
|
|
37
|
+
deleteGraph(id: string): Promise<void>;
|
|
28
38
|
private filePath;
|
|
29
39
|
private readIndex;
|
|
30
40
|
private updateIndex;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"task-graph-store.d.ts","sourceRoot":"","sources":["../src/task-graph-store.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"task-graph-store.d.ts","sourceRoot":"","sources":["../src/task-graph-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,wBAAwB,CAAC;AAGlE,MAAM,WAAW,qBAAqB;IACpC,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0BD;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAAoC;IAEtD,YAAY,IAAI,EAAE,qBAAqB,EAGtC;IAEK,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1C;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAQhD;IAEK,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAI3C;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASzC;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzC;IAED,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzC;IAED,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAE/C;IAEK,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAEnF;IAEK,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3C;IAED,OAAO,CAAC,QAAQ;YAIF,SAAS;YAWT,WAAW;YAuBX,eAAe;CAK9B"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wrongstack/sdd",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.297.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"description": "WrongStack Spec-Driven Development engine — standalone package extracted from @wrongstack/core. Task graph generation, tracking, execution, lifecycle management, and AI-driven spec building for SDD workflows.",
|
|
6
6
|
"repository": {
|
|
@@ -26,8 +26,8 @@
|
|
|
26
26
|
"dist"
|
|
27
27
|
],
|
|
28
28
|
"dependencies": {
|
|
29
|
-
"@wrongstack/core": "0.
|
|
30
|
-
"@wrongstack/kanban": "0.
|
|
29
|
+
"@wrongstack/core": "0.297.0",
|
|
30
|
+
"@wrongstack/kanban": "0.297.0"
|
|
31
31
|
},
|
|
32
32
|
"devDependencies": {
|
|
33
33
|
"@types/node": "^26.1.1",
|