@captain_z/zsk 1.8.6 → 1.8.7
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/bin.js +128 -0
- package/dist/bin.js.map +1 -1
- package/dist/commands/add-flow.js +7 -1
- package/dist/commands/add-flow.js.map +1 -1
- package/dist/commands/add.js +22 -5
- package/dist/commands/add.js.map +1 -1
- package/dist/commands/dispatch.d.ts +4 -0
- package/dist/commands/dispatch.js +483 -7
- package/dist/commands/dispatch.js.map +1 -1
- package/dist/commands/doctor.js +21 -5
- package/dist/commands/doctor.js.map +1 -1
- package/dist/commands/issue.d.ts +1 -0
- package/dist/commands/issue.js +2 -2
- package/dist/commands/issue.js.map +1 -1
- package/dist/commands/project-init.js +14 -8
- package/dist/commands/project-init.js.map +1 -1
- package/dist/commands/work.d.ts +34 -0
- package/dist/commands/work.js +1769 -0
- package/dist/commands/work.js.map +1 -0
- package/dist/commands/workflow.d.ts +32 -0
- package/dist/commands/workflow.js +270 -0
- package/dist/commands/workflow.js.map +1 -0
- package/dist/core/config.d.ts +29 -0
- package/dist/core/config.js +157 -1
- package/dist/core/config.js.map +1 -1
- package/dist/core/skill-classification.d.ts +13 -0
- package/dist/core/skill-classification.js +50 -0
- package/dist/core/skill-classification.js.map +1 -0
- package/dist/core/stage-clarity-verification.js +58 -7
- package/dist/core/stage-clarity-verification.js.map +1 -1
- package/dist/core/template-registry.js +26 -7
- package/dist/core/template-registry.js.map +1 -1
- package/dist/core/work-ledger.d.ts +44 -0
- package/dist/core/work-ledger.js +88 -0
- package/dist/core/work-ledger.js.map +1 -0
- package/dist/core/work-provider-adapters.d.ts +110 -0
- package/dist/core/work-provider-adapters.js +484 -0
- package/dist/core/work-provider-adapters.js.map +1 -0
- package/dist/core/workflow-graph.d.ts +100 -0
- package/dist/core/workflow-graph.js +655 -0
- package/dist/core/workflow-graph.js.map +1 -0
- package/dist/core/workspace-conformance.js +55 -0
- package/dist/core/workspace-conformance.js.map +1 -1
- package/dist/core/workspace-layout.d.ts +3 -1
- package/dist/core/workspace-layout.js +4 -0
- package/dist/core/workspace-layout.js.map +1 -1
- package/package.json +2 -2
- package/schemas/zsk-config.schema.json +112 -1
- package/templates/module/frontend-module/CONTEXT.md +22 -0
- package/templates/module/frontend-module/design.md +1 -1
- package/templates/module/frontend-module/proposal.md +1 -1
- package/templates/module/frontend-module/spec.md +1 -1
- package/templates/module/frontend-module/tasks.md +14 -1
- package/templates/project-init/.zsk/CONTEXT.md +35 -0
- package/templates/project-init/.zsk/README.md +94 -10
- package/templates/project-init/.zsk/config.yaml +2 -0
- package/templates/project-init/.zsk/docs/CONFIG-SCHEMA.md +13 -1
- package/templates/project-init/.zsk/docs/PROJECT-CONFIG.md +25 -7
- package/templates/project-init/.zsk/docs/SYSTEM-SPEC.md +1 -0
- package/templates/project-init/.zsk/team.yaml +218 -0
- package/templates/project-init/.zsk/work.yaml +75 -0
- package/templates/project-init/.zsk/evidence/README.md +0 -21
- package/templates/project-init/.zsk/evidence/prepare/README.md +0 -22
- package/templates/project-init/.zsk/issues/README.md +0 -10
- package/templates/project-init/.zsk/templates/module/README.md +0 -13
- package/templates/project-init/.zsk/templates/module/design.md +0 -22
- package/templates/project-init/.zsk/templates/module/module.yaml +0 -15
- package/templates/project-init/.zsk/templates/module/proposal.md +0 -20
- package/templates/project-init/.zsk/templates/module/spec.md +0 -22
- package/templates/project-init/.zsk/templates/module/tasks.md +0 -16
|
@@ -18,6 +18,8 @@ const FOUNDER_OS_DEFAULTS = {
|
|
|
18
18
|
},
|
|
19
19
|
customize: {
|
|
20
20
|
roles: ".zsk/roles.yaml",
|
|
21
|
+
team: ".zsk/team.yaml",
|
|
22
|
+
work: ".zsk/work.yaml",
|
|
21
23
|
},
|
|
22
24
|
paths: {
|
|
23
25
|
docs: ".zsk/docs",
|
|
@@ -143,15 +145,9 @@ const FOUNDER_OS_TEMPLATE = {
|
|
|
143
145
|
{
|
|
144
146
|
name: "coding",
|
|
145
147
|
skill: "coding",
|
|
146
|
-
gate: "implementation is scoped, tested, and ready for
|
|
148
|
+
gate: "implementation is scoped, tested, and ready for verification",
|
|
147
149
|
defaultRoles: ["lead-integrator", "executor", "qa-engineer", "verifier"],
|
|
148
150
|
},
|
|
149
|
-
{
|
|
150
|
-
name: "review",
|
|
151
|
-
skill: "review",
|
|
152
|
-
gate: "implementation is reviewed against scope, source truth, tests, security, and maintainability",
|
|
153
|
-
defaultRoles: ["lead-integrator", "senior-engineering-reviewer", "security-reviewer", "ue-a11y-reviewer", "qa-engineer", "verifier"],
|
|
154
|
-
},
|
|
155
151
|
{
|
|
156
152
|
name: "verify",
|
|
157
153
|
skill: "verify",
|
|
@@ -204,6 +200,29 @@ export function renderWorkflowEject() {
|
|
|
204
200
|
"# ZSK Workflow",
|
|
205
201
|
"",
|
|
206
202
|
"profile: zsk-sdlc",
|
|
203
|
+
"strategy: adaptive",
|
|
204
|
+
"stageSelection:",
|
|
205
|
+
" mode: ai-decided",
|
|
206
|
+
" allowCustomStages: true",
|
|
207
|
+
" preferMinimalStages: false",
|
|
208
|
+
" requireStageContract: true",
|
|
209
|
+
" preferEvidenceStages: false",
|
|
210
|
+
"workflowGraph:",
|
|
211
|
+
" output: .zsk/plans/{run-id}/workflow-graph.yaml",
|
|
212
|
+
" requiresReason: true",
|
|
213
|
+
" requiresInputs: true",
|
|
214
|
+
" requiresOutputs: true",
|
|
215
|
+
" requiresQualityGate: true",
|
|
216
|
+
" failureReturnsTo: nearest-owner-stage",
|
|
217
|
+
"capabilities:",
|
|
218
|
+
" enabled: [prepare-resources, issue, evidence, review, defect, learn]",
|
|
219
|
+
"qualityGates:",
|
|
220
|
+
" required: [stage-contract, sourced-outputs, smoke, review, ready, verify, acceptance, archive]",
|
|
221
|
+
" optional: [demo, deploy]",
|
|
222
|
+
"",
|
|
223
|
+
"# Compatibility defaults only. This list contains stage skills; review, smoke,",
|
|
224
|
+
"# ready, commit, deploy, defect, dispatch, learn, fix, and flow are selected",
|
|
225
|
+
"# internally as capabilities, gates, or modes when the workflow graph needs them.",
|
|
207
226
|
"stages:",
|
|
208
227
|
...FOUNDER_OS_TEMPLATE.stages.flatMap((stage) => [
|
|
209
228
|
` - name: ${stage.name}`,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"template-registry.js","sourceRoot":"","sources":["../../src/core/template-registry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAuBhD,MAAM,mBAAmB,GAAkB;IACzC,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,EAAE,gBAAgB;KACvB;IACD,QAAQ,EAAE;QACR,EAAE,EAAE,mBAAmB;QACvB,OAAO,EAAE,CAAC;KACX;IACD,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE;QACR,OAAO,EAAE,UAAU;KACpB;IACD,KAAK,EAAE;QACL,gBAAgB,EAAE,CAAC;KACpB;IACD,SAAS,EAAE;QACT,KAAK,EAAE,iBAAiB;
|
|
1
|
+
{"version":3,"file":"template-registry.js","sourceRoot":"","sources":["../../src/core/template-registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { ProjectConfig } from "./config.js";
|
|
2
|
+
export type WorkEvent = {
|
|
3
|
+
event?: string;
|
|
4
|
+
version?: number;
|
|
5
|
+
occurredAt?: string;
|
|
6
|
+
producer?: {
|
|
7
|
+
skill?: string;
|
|
8
|
+
stage?: string;
|
|
9
|
+
};
|
|
10
|
+
workItem?: {
|
|
11
|
+
id?: string;
|
|
12
|
+
type?: string;
|
|
13
|
+
title?: string;
|
|
14
|
+
project?: string | {
|
|
15
|
+
id?: string;
|
|
16
|
+
name?: string;
|
|
17
|
+
};
|
|
18
|
+
module?: string | {
|
|
19
|
+
id?: string;
|
|
20
|
+
name?: string;
|
|
21
|
+
};
|
|
22
|
+
stage?: string;
|
|
23
|
+
status?: string;
|
|
24
|
+
sourceArtifacts?: unknown[];
|
|
25
|
+
externalRefs?: Record<string, unknown>;
|
|
26
|
+
[key: string]: unknown;
|
|
27
|
+
};
|
|
28
|
+
assignment?: Record<string, unknown>;
|
|
29
|
+
status?: {
|
|
30
|
+
from?: string;
|
|
31
|
+
to?: string;
|
|
32
|
+
[key: string]: unknown;
|
|
33
|
+
};
|
|
34
|
+
links?: Record<string, unknown>;
|
|
35
|
+
evidence?: Record<string, unknown>;
|
|
36
|
+
[key: string]: unknown;
|
|
37
|
+
};
|
|
38
|
+
export declare function resolveWorkLedgerPath(target: string, config: ProjectConfig): Promise<{
|
|
39
|
+
workConfigPath: string;
|
|
40
|
+
ledgerPath: string;
|
|
41
|
+
}>;
|
|
42
|
+
export declare function readWorkEvents(path: string): Promise<WorkEvent[]>;
|
|
43
|
+
export declare function appendWorkEvents(path: string, events: WorkEvent[]): Promise<void>;
|
|
44
|
+
export declare function latestWorkItem(events: WorkEvent[], localId: string): NonNullable<WorkEvent["workItem"]> | undefined;
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import { access, appendFile, mkdir, readFile } from "node:fs/promises";
|
|
2
|
+
import { dirname, resolve } from "node:path";
|
|
3
|
+
import YAML from "yaml";
|
|
4
|
+
import { isPathInside, resolveProjectPath } from "./workspace-conformance.js";
|
|
5
|
+
export async function resolveWorkLedgerPath(target, config) {
|
|
6
|
+
const workConfigPath = resolveInsideProject(target, config.customize?.work ?? ".zsk/work.yaml");
|
|
7
|
+
let ledgerRel = ".zsk/work.jsonl";
|
|
8
|
+
try {
|
|
9
|
+
const raw = await readFile(workConfigPath, "utf8");
|
|
10
|
+
const parsed = YAML.parse(raw);
|
|
11
|
+
if (isRecord(parsed)) {
|
|
12
|
+
const workConfig = parsed;
|
|
13
|
+
ledgerRel = workConfig.ledger?.path ?? ledgerRel;
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
ledgerRel = ".zsk/work.jsonl";
|
|
18
|
+
}
|
|
19
|
+
return {
|
|
20
|
+
workConfigPath,
|
|
21
|
+
ledgerPath: resolveInsideProject(target, ledgerRel),
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
export async function readWorkEvents(path) {
|
|
25
|
+
try {
|
|
26
|
+
await access(path);
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
return [];
|
|
30
|
+
}
|
|
31
|
+
const raw = await readFile(path, "utf8");
|
|
32
|
+
const events = [];
|
|
33
|
+
for (const [index, line] of raw.split(/\r?\n/).entries()) {
|
|
34
|
+
const trimmed = line.trim();
|
|
35
|
+
if (!trimmed)
|
|
36
|
+
continue;
|
|
37
|
+
try {
|
|
38
|
+
const parsed = JSON.parse(trimmed);
|
|
39
|
+
if (isRecord(parsed)) {
|
|
40
|
+
events.push(parsed);
|
|
41
|
+
continue;
|
|
42
|
+
}
|
|
43
|
+
events.push(invalidWorkEvent(index + 1, "Invalid work event"));
|
|
44
|
+
}
|
|
45
|
+
catch {
|
|
46
|
+
events.push(invalidWorkEvent(index + 1, "Invalid JSONL event"));
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
return events;
|
|
50
|
+
}
|
|
51
|
+
export async function appendWorkEvents(path, events) {
|
|
52
|
+
await mkdir(dirname(path), { recursive: true });
|
|
53
|
+
await appendFile(path, events.map((event) => JSON.stringify(event)).join("\n") + "\n", "utf8");
|
|
54
|
+
}
|
|
55
|
+
export function latestWorkItem(events, localId) {
|
|
56
|
+
for (const event of [...events].reverse()) {
|
|
57
|
+
if (event.workItem?.id === localId)
|
|
58
|
+
return event.workItem;
|
|
59
|
+
}
|
|
60
|
+
return undefined;
|
|
61
|
+
}
|
|
62
|
+
function invalidWorkEvent(line, title) {
|
|
63
|
+
return {
|
|
64
|
+
event: "invalid",
|
|
65
|
+
producer: { skill: "work", stage: "sync" },
|
|
66
|
+
workItem: {
|
|
67
|
+
id: `line-${line}`,
|
|
68
|
+
type: "invalid",
|
|
69
|
+
title,
|
|
70
|
+
project: "unknown",
|
|
71
|
+
module: "unknown",
|
|
72
|
+
stage: "sync",
|
|
73
|
+
status: "blocked",
|
|
74
|
+
sourceArtifacts: [],
|
|
75
|
+
},
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
function resolveInsideProject(root, value) {
|
|
79
|
+
const resolved = resolveProjectPath(root, value);
|
|
80
|
+
if (!isPathInside(resolve(root), resolved)) {
|
|
81
|
+
throw new Error(`work ledger path must stay inside the project: ${value}`);
|
|
82
|
+
}
|
|
83
|
+
return resolved;
|
|
84
|
+
}
|
|
85
|
+
function isRecord(value) {
|
|
86
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
87
|
+
}
|
|
88
|
+
//# sourceMappingURL=work-ledger.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"work-ledger.js","sourceRoot":"","sources":["../../src/core/work-ledger.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import type { WorkEvent } from "./work-ledger.js";
|
|
2
|
+
export type WorkProviderConfig = {
|
|
3
|
+
adapter?: string;
|
|
4
|
+
mode?: string;
|
|
5
|
+
workspace?: string;
|
|
6
|
+
expertCatalog?: {
|
|
7
|
+
path?: string;
|
|
8
|
+
};
|
|
9
|
+
commandPlan?: {
|
|
10
|
+
executable?: string;
|
|
11
|
+
mode?: string;
|
|
12
|
+
};
|
|
13
|
+
projectMapping?: {
|
|
14
|
+
strategy?: string;
|
|
15
|
+
projects?: Record<string, string | undefined>;
|
|
16
|
+
};
|
|
17
|
+
statusMapping?: Record<string, string | undefined>;
|
|
18
|
+
assignment?: Record<string, unknown>;
|
|
19
|
+
};
|
|
20
|
+
export type WorkSyncPlanItem = {
|
|
21
|
+
line: number;
|
|
22
|
+
event: string;
|
|
23
|
+
action: string;
|
|
24
|
+
localId: string | null;
|
|
25
|
+
project: string | null;
|
|
26
|
+
module: string | null;
|
|
27
|
+
stage: string | null;
|
|
28
|
+
localStatus: string | null;
|
|
29
|
+
providerStatus: string | null;
|
|
30
|
+
remoteRef: unknown;
|
|
31
|
+
remoteReady: boolean;
|
|
32
|
+
blockedReasons: string[];
|
|
33
|
+
};
|
|
34
|
+
export type WorkProviderCommand = {
|
|
35
|
+
line: number;
|
|
36
|
+
action: string;
|
|
37
|
+
operation: string;
|
|
38
|
+
executable: string;
|
|
39
|
+
argv: string[];
|
|
40
|
+
display: string;
|
|
41
|
+
metadata: Record<string, unknown>;
|
|
42
|
+
dryRun: true;
|
|
43
|
+
remoteSideEffects: "none";
|
|
44
|
+
ready: boolean;
|
|
45
|
+
blockedReasons: string[];
|
|
46
|
+
notes: string[];
|
|
47
|
+
};
|
|
48
|
+
export type WorkProviderCommandPlan = {
|
|
49
|
+
mode: "dry-run";
|
|
50
|
+
adapter: string | null;
|
|
51
|
+
executable: string;
|
|
52
|
+
commandCount: number;
|
|
53
|
+
blockedCount: number;
|
|
54
|
+
commands: WorkProviderCommand[];
|
|
55
|
+
};
|
|
56
|
+
export type WorkAssignmentCommandInput = {
|
|
57
|
+
workItem: {
|
|
58
|
+
id: string;
|
|
59
|
+
project: string | null;
|
|
60
|
+
module: string | null;
|
|
61
|
+
stage: string | null;
|
|
62
|
+
};
|
|
63
|
+
assignment: {
|
|
64
|
+
mode: "agent" | "squad" | "role";
|
|
65
|
+
role: string;
|
|
66
|
+
agent: string | null;
|
|
67
|
+
squad: string | null;
|
|
68
|
+
providerAgent: string | null;
|
|
69
|
+
rationale: string;
|
|
70
|
+
};
|
|
71
|
+
};
|
|
72
|
+
export type WorkProviderExecutableInput = {
|
|
73
|
+
provider: string;
|
|
74
|
+
providerConfig: WorkProviderConfig;
|
|
75
|
+
};
|
|
76
|
+
export type WorkProviderItemCommandInput = WorkProviderExecutableInput & {
|
|
77
|
+
item: WorkSyncPlanItem;
|
|
78
|
+
event: WorkEvent | undefined;
|
|
79
|
+
providerConfigured: boolean;
|
|
80
|
+
executable: string;
|
|
81
|
+
};
|
|
82
|
+
export type WorkProviderAssignmentCommandInput = WorkProviderExecutableInput & {
|
|
83
|
+
providerConfigured: boolean;
|
|
84
|
+
workItem: WorkAssignmentCommandInput["workItem"];
|
|
85
|
+
assignment: WorkAssignmentCommandInput["assignment"];
|
|
86
|
+
executable: string;
|
|
87
|
+
};
|
|
88
|
+
export type WorkProviderAdapter = {
|
|
89
|
+
id: string;
|
|
90
|
+
defaultExecutable: (input: WorkProviderExecutableInput) => string;
|
|
91
|
+
buildItemCommand: (input: WorkProviderItemCommandInput) => WorkProviderCommand;
|
|
92
|
+
buildAssignmentCommand: (input: WorkProviderAssignmentCommandInput) => WorkProviderCommand;
|
|
93
|
+
};
|
|
94
|
+
export declare const workProviderAdapters: Record<string, WorkProviderAdapter>;
|
|
95
|
+
export declare function buildProviderCommandPlan(input: {
|
|
96
|
+
provider: string;
|
|
97
|
+
providerConfig: WorkProviderConfig;
|
|
98
|
+
providerConfigured: boolean;
|
|
99
|
+
items: WorkSyncPlanItem[];
|
|
100
|
+
events: WorkEvent[];
|
|
101
|
+
}): WorkProviderCommandPlan;
|
|
102
|
+
export declare function buildAssignmentProviderCommandPlan(input: {
|
|
103
|
+
provider: string;
|
|
104
|
+
providerConfig: WorkProviderConfig;
|
|
105
|
+
providerConfigured: boolean;
|
|
106
|
+
workItem: WorkAssignmentCommandInput["workItem"];
|
|
107
|
+
assignment: WorkAssignmentCommandInput["assignment"];
|
|
108
|
+
}): WorkProviderCommandPlan;
|
|
109
|
+
export declare function assignmentProviderRef(assignment: Record<string, unknown>, provider: string): string | null;
|
|
110
|
+
export declare function commandDisplayWithMetadata(command: WorkProviderCommand): string;
|