@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.
Files changed (70) hide show
  1. package/dist/bin.js +128 -0
  2. package/dist/bin.js.map +1 -1
  3. package/dist/commands/add-flow.js +7 -1
  4. package/dist/commands/add-flow.js.map +1 -1
  5. package/dist/commands/add.js +22 -5
  6. package/dist/commands/add.js.map +1 -1
  7. package/dist/commands/dispatch.d.ts +4 -0
  8. package/dist/commands/dispatch.js +483 -7
  9. package/dist/commands/dispatch.js.map +1 -1
  10. package/dist/commands/doctor.js +21 -5
  11. package/dist/commands/doctor.js.map +1 -1
  12. package/dist/commands/issue.d.ts +1 -0
  13. package/dist/commands/issue.js +2 -2
  14. package/dist/commands/issue.js.map +1 -1
  15. package/dist/commands/project-init.js +14 -8
  16. package/dist/commands/project-init.js.map +1 -1
  17. package/dist/commands/work.d.ts +34 -0
  18. package/dist/commands/work.js +1769 -0
  19. package/dist/commands/work.js.map +1 -0
  20. package/dist/commands/workflow.d.ts +32 -0
  21. package/dist/commands/workflow.js +270 -0
  22. package/dist/commands/workflow.js.map +1 -0
  23. package/dist/core/config.d.ts +29 -0
  24. package/dist/core/config.js +157 -1
  25. package/dist/core/config.js.map +1 -1
  26. package/dist/core/skill-classification.d.ts +13 -0
  27. package/dist/core/skill-classification.js +50 -0
  28. package/dist/core/skill-classification.js.map +1 -0
  29. package/dist/core/stage-clarity-verification.js +58 -7
  30. package/dist/core/stage-clarity-verification.js.map +1 -1
  31. package/dist/core/template-registry.js +26 -7
  32. package/dist/core/template-registry.js.map +1 -1
  33. package/dist/core/work-ledger.d.ts +44 -0
  34. package/dist/core/work-ledger.js +88 -0
  35. package/dist/core/work-ledger.js.map +1 -0
  36. package/dist/core/work-provider-adapters.d.ts +110 -0
  37. package/dist/core/work-provider-adapters.js +484 -0
  38. package/dist/core/work-provider-adapters.js.map +1 -0
  39. package/dist/core/workflow-graph.d.ts +100 -0
  40. package/dist/core/workflow-graph.js +655 -0
  41. package/dist/core/workflow-graph.js.map +1 -0
  42. package/dist/core/workspace-conformance.js +55 -0
  43. package/dist/core/workspace-conformance.js.map +1 -1
  44. package/dist/core/workspace-layout.d.ts +3 -1
  45. package/dist/core/workspace-layout.js +4 -0
  46. package/dist/core/workspace-layout.js.map +1 -1
  47. package/package.json +2 -2
  48. package/schemas/zsk-config.schema.json +112 -1
  49. package/templates/module/frontend-module/CONTEXT.md +22 -0
  50. package/templates/module/frontend-module/design.md +1 -1
  51. package/templates/module/frontend-module/proposal.md +1 -1
  52. package/templates/module/frontend-module/spec.md +1 -1
  53. package/templates/module/frontend-module/tasks.md +14 -1
  54. package/templates/project-init/.zsk/CONTEXT.md +35 -0
  55. package/templates/project-init/.zsk/README.md +94 -10
  56. package/templates/project-init/.zsk/config.yaml +2 -0
  57. package/templates/project-init/.zsk/docs/CONFIG-SCHEMA.md +13 -1
  58. package/templates/project-init/.zsk/docs/PROJECT-CONFIG.md +25 -7
  59. package/templates/project-init/.zsk/docs/SYSTEM-SPEC.md +1 -0
  60. package/templates/project-init/.zsk/team.yaml +218 -0
  61. package/templates/project-init/.zsk/work.yaml +75 -0
  62. package/templates/project-init/.zsk/evidence/README.md +0 -21
  63. package/templates/project-init/.zsk/evidence/prepare/README.md +0 -22
  64. package/templates/project-init/.zsk/issues/README.md +0 -10
  65. package/templates/project-init/.zsk/templates/module/README.md +0 -13
  66. package/templates/project-init/.zsk/templates/module/design.md +0 -22
  67. package/templates/project-init/.zsk/templates/module/module.yaml +0 -15
  68. package/templates/project-init/.zsk/templates/module/proposal.md +0 -20
  69. package/templates/project-init/.zsk/templates/module/spec.md +0 -22
  70. 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 smoke",
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":"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"}
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;