@plumbus/core 0.4.2 → 0.5.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/README.md +1 -1
- package/dist/.tsbuildinfo +1 -1
- package/dist/api/route-generator.d.ts.map +1 -1
- package/dist/api/route-generator.js +27 -14
- package/dist/api/route-generator.js.map +1 -1
- package/dist/cli/cli.d.ts.map +1 -1
- package/dist/cli/cli.js +2 -1
- package/dist/cli/cli.js.map +1 -1
- package/dist/cli/commands/dev.d.ts.map +1 -1
- package/dist/cli/commands/dev.js +38 -149
- package/dist/cli/commands/dev.js.map +1 -1
- package/dist/cli/commands/doctor.d.ts +6 -0
- package/dist/cli/commands/doctor.d.ts.map +1 -1
- package/dist/cli/commands/doctor.js +92 -4
- package/dist/cli/commands/doctor.js.map +1 -1
- package/dist/cli/commands/event.d.ts.map +1 -1
- package/dist/cli/commands/event.js +3 -0
- package/dist/cli/commands/event.js.map +1 -1
- package/dist/cli/commands/events-ops.d.ts +4 -0
- package/dist/cli/commands/events-ops.d.ts.map +1 -0
- package/dist/cli/commands/events-ops.js +203 -0
- package/dist/cli/commands/events-ops.js.map +1 -0
- package/dist/cli/commands/flow.d.ts.map +1 -1
- package/dist/cli/commands/flow.js +49 -1
- package/dist/cli/commands/flow.js.map +1 -1
- package/dist/cli/commands/generate.d.ts +4 -0
- package/dist/cli/commands/generate.d.ts.map +1 -1
- package/dist/cli/commands/generate.js +94 -3
- package/dist/cli/commands/generate.js.map +1 -1
- package/dist/cli/commands/index.d.ts +1 -0
- package/dist/cli/commands/index.d.ts.map +1 -1
- package/dist/cli/commands/index.js +1 -0
- package/dist/cli/commands/index.js.map +1 -1
- package/dist/cli/commands/init.d.ts +1 -1
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +13 -3
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/mcp.d.ts.map +1 -1
- package/dist/cli/commands/mcp.js +2 -0
- package/dist/cli/commands/mcp.js.map +1 -1
- package/dist/cli/commands/start.d.ts +3 -6
- package/dist/cli/commands/start.d.ts.map +1 -1
- package/dist/cli/commands/start.js +71 -180
- package/dist/cli/commands/start.js.map +1 -1
- package/dist/cli/commands/verify.d.ts +3 -1
- package/dist/cli/commands/verify.d.ts.map +1 -1
- package/dist/cli/commands/verify.js +17 -9
- package/dist/cli/commands/verify.js.map +1 -1
- package/dist/cli/commands/worker.d.ts +19 -0
- package/dist/cli/commands/worker.d.ts.map +1 -0
- package/dist/cli/commands/worker.js +234 -0
- package/dist/cli/commands/worker.js.map +1 -0
- package/dist/cli/mcp-serve-context.d.ts +3 -0
- package/dist/cli/mcp-serve-context.d.ts.map +1 -1
- package/dist/cli/mcp-serve-context.js +16 -1
- package/dist/cli/mcp-serve-context.js.map +1 -1
- package/dist/cli/templates/resources.d.ts.map +1 -1
- package/dist/cli/templates/resources.js +7 -2
- package/dist/cli/templates/resources.js.map +1 -1
- package/dist/cli/utils.d.ts +4 -0
- package/dist/cli/utils.d.ts.map +1 -1
- package/dist/cli/utils.js +9 -0
- package/dist/cli/utils.js.map +1 -1
- package/dist/data/drift-inspector.d.ts +2 -2
- package/dist/data/drift-inspector.d.ts.map +1 -1
- package/dist/data/drift-inspector.js +2 -1
- package/dist/data/drift-inspector.js.map +1 -1
- package/dist/data/migration.d.ts.map +1 -1
- package/dist/data/migration.js +2 -0
- package/dist/data/migration.js.map +1 -1
- package/dist/define/defineCapability.d.ts +5 -0
- package/dist/define/defineCapability.d.ts.map +1 -1
- package/dist/define/defineCapability.js +23 -0
- package/dist/define/defineCapability.js.map +1 -1
- package/dist/errors/http.d.ts.map +1 -1
- package/dist/errors/http.js +1 -0
- package/dist/errors/http.js.map +1 -1
- package/dist/errors/index.d.ts.map +1 -1
- package/dist/errors/index.js +1 -0
- package/dist/errors/index.js.map +1 -1
- package/dist/events/dispatcher.d.ts +4 -0
- package/dist/events/dispatcher.d.ts.map +1 -1
- package/dist/events/dispatcher.js +24 -1
- package/dist/events/dispatcher.js.map +1 -1
- package/dist/events/emitter.d.ts +2 -0
- package/dist/events/emitter.d.ts.map +1 -1
- package/dist/events/emitter.js +6 -3
- package/dist/events/emitter.js.map +1 -1
- package/dist/events/queue-adapter.d.ts +7 -0
- package/dist/events/queue-adapter.d.ts.map +1 -0
- package/dist/events/queue-adapter.js +4 -0
- package/dist/events/queue-adapter.js.map +1 -0
- package/dist/events/queue.d.ts +16 -13
- package/dist/events/queue.d.ts.map +1 -1
- package/dist/events/queue.js +79 -22
- package/dist/events/queue.js.map +1 -1
- package/dist/events/worker.d.ts +4 -0
- package/dist/events/worker.d.ts.map +1 -1
- package/dist/events/worker.js +47 -1
- package/dist/events/worker.js.map +1 -1
- package/dist/execution/canonical-name.d.ts +13 -0
- package/dist/execution/canonical-name.d.ts.map +1 -0
- package/dist/execution/canonical-name.js +17 -0
- package/dist/execution/canonical-name.js.map +1 -0
- package/dist/execution/capability-executor.d.ts +1 -1
- package/dist/execution/capability-executor.d.ts.map +1 -1
- package/dist/execution/capability-executor.js +52 -24
- package/dist/execution/capability-executor.js.map +1 -1
- package/dist/execution/capability-invocation.d.ts +34 -0
- package/dist/execution/capability-invocation.d.ts.map +1 -0
- package/dist/execution/capability-invocation.js +138 -0
- package/dist/execution/capability-invocation.js.map +1 -0
- package/dist/execution/capability-registry.d.ts +6 -4
- package/dist/execution/capability-registry.d.ts.map +1 -1
- package/dist/execution/capability-registry.js +13 -7
- package/dist/execution/capability-registry.js.map +1 -1
- package/dist/execution/context-factory.d.ts.map +1 -1
- package/dist/execution/context-factory.js +12 -1
- package/dist/execution/context-factory.js.map +1 -1
- package/dist/execution/index.d.ts +4 -0
- package/dist/execution/index.d.ts.map +1 -1
- package/dist/execution/index.js +2 -0
- package/dist/execution/index.js.map +1 -1
- package/dist/execution/invocation-emit-scope.d.ts +11 -0
- package/dist/execution/invocation-emit-scope.d.ts.map +1 -0
- package/dist/execution/invocation-emit-scope.js +8 -0
- package/dist/execution/invocation-emit-scope.js.map +1 -0
- package/dist/flows/engine.d.ts +7 -1
- package/dist/flows/engine.d.ts.map +1 -1
- package/dist/flows/engine.js +73 -10
- package/dist/flows/engine.js.map +1 -1
- package/dist/flows/flow-delayed.d.ts +34 -0
- package/dist/flows/flow-delayed.d.ts.map +1 -0
- package/dist/flows/flow-delayed.js +60 -0
- package/dist/flows/flow-delayed.js.map +1 -0
- package/dist/flows/flow-queue.d.ts +10 -0
- package/dist/flows/flow-queue.d.ts.map +1 -0
- package/dist/flows/flow-queue.js +25 -0
- package/dist/flows/flow-queue.js.map +1 -0
- package/dist/flows/scheduler.d.ts +0 -12
- package/dist/flows/scheduler.d.ts.map +1 -1
- package/dist/flows/scheduler.js +15 -0
- package/dist/flows/scheduler.js.map +1 -1
- package/dist/flows/schema.d.ts +17 -0
- package/dist/flows/schema.d.ts.map +1 -1
- package/dist/flows/schema.js +2 -0
- package/dist/flows/schema.js.map +1 -1
- package/dist/flows/step-consumer.d.ts +24 -0
- package/dist/flows/step-consumer.d.ts.map +1 -0
- package/dist/flows/step-consumer.js +72 -0
- package/dist/flows/step-consumer.js.map +1 -0
- package/dist/flows/triggers.d.ts +1 -1
- package/dist/flows/triggers.d.ts.map +1 -1
- package/dist/flows/triggers.js +5 -7
- package/dist/flows/triggers.js.map +1 -1
- package/dist/governance/capability-source-scan.d.ts +7 -0
- package/dist/governance/capability-source-scan.d.ts.map +1 -0
- package/dist/governance/capability-source-scan.js +80 -0
- package/dist/governance/capability-source-scan.js.map +1 -0
- package/dist/governance/rules/architecture.d.ts.map +1 -1
- package/dist/governance/rules/architecture.js +2 -0
- package/dist/governance/rules/architecture.js.map +1 -1
- package/dist/governance/rules/capability-dependencies.d.ts +8 -0
- package/dist/governance/rules/capability-dependencies.d.ts.map +1 -0
- package/dist/governance/rules/capability-dependencies.js +195 -0
- package/dist/governance/rules/capability-dependencies.js.map +1 -0
- package/dist/governance/rules/index.d.ts +2 -0
- package/dist/governance/rules/index.d.ts.map +1 -1
- package/dist/governance/rules/index.js +2 -0
- package/dist/governance/rules/index.js.map +1 -1
- package/dist/governance/rules/worker.d.ts +9 -0
- package/dist/governance/rules/worker.d.ts.map +1 -0
- package/dist/governance/rules/worker.js +89 -0
- package/dist/governance/rules/worker.js.map +1 -0
- package/dist/index.d.ts +6 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/jobs/dispatch.d.ts +18 -0
- package/dist/jobs/dispatch.d.ts.map +1 -0
- package/dist/jobs/dispatch.js +50 -0
- package/dist/jobs/dispatch.js.map +1 -0
- package/dist/jobs/index.d.ts +9 -0
- package/dist/jobs/index.d.ts.map +1 -0
- package/dist/jobs/index.js +8 -0
- package/dist/jobs/index.js.map +1 -0
- package/dist/jobs/routes.d.ts +10 -0
- package/dist/jobs/routes.d.ts.map +1 -0
- package/dist/jobs/routes.js +44 -0
- package/dist/jobs/routes.js.map +1 -0
- package/dist/jobs/schema.d.ts +264 -0
- package/dist/jobs/schema.d.ts.map +1 -0
- package/dist/jobs/schema.js +34 -0
- package/dist/jobs/schema.js.map +1 -0
- package/dist/jobs/service.d.ts +52 -0
- package/dist/jobs/service.d.ts.map +1 -0
- package/dist/jobs/service.js +168 -0
- package/dist/jobs/service.js.map +1 -0
- package/dist/jobs/types.d.ts +30 -0
- package/dist/jobs/types.d.ts.map +1 -0
- package/dist/jobs/types.js +4 -0
- package/dist/jobs/types.js.map +1 -0
- package/dist/mcp/manifest-generator.d.ts.map +1 -1
- package/dist/mcp/manifest-generator.js +3 -2
- package/dist/mcp/manifest-generator.js.map +1 -1
- package/dist/observability/metrics.d.ts +9 -1
- package/dist/observability/metrics.d.ts.map +1 -1
- package/dist/observability/metrics.js +28 -1
- package/dist/observability/metrics.js.map +1 -1
- package/dist/runtime/bootstrap.d.ts +51 -0
- package/dist/runtime/bootstrap.d.ts.map +1 -0
- package/dist/runtime/bootstrap.js +140 -0
- package/dist/runtime/bootstrap.js.map +1 -0
- package/dist/runtime/index.d.ts +7 -0
- package/dist/runtime/index.d.ts.map +1 -0
- package/dist/runtime/index.js +6 -0
- package/dist/runtime/index.js.map +1 -0
- package/dist/runtime/load-extensions.d.ts +4 -0
- package/dist/runtime/load-extensions.d.ts.map +1 -0
- package/dist/runtime/load-extensions.js +41 -0
- package/dist/runtime/load-extensions.js.map +1 -0
- package/dist/runtime/queue-factory.d.ts +44 -0
- package/dist/runtime/queue-factory.d.ts.map +1 -0
- package/dist/runtime/queue-factory.js +156 -0
- package/dist/runtime/queue-factory.js.map +1 -0
- package/dist/runtime/register-consumers.d.ts +29 -0
- package/dist/runtime/register-consumers.d.ts.map +1 -0
- package/dist/runtime/register-consumers.js +233 -0
- package/dist/runtime/register-consumers.js.map +1 -0
- package/dist/runtime/start-worker-pool.d.ts +32 -0
- package/dist/runtime/start-worker-pool.d.ts.map +1 -0
- package/dist/runtime/start-worker-pool.js +91 -0
- package/dist/runtime/start-worker-pool.js.map +1 -0
- package/dist/runtime/worker-health.d.ts +19 -0
- package/dist/runtime/worker-health.d.ts.map +1 -0
- package/dist/runtime/worker-health.js +41 -0
- package/dist/runtime/worker-health.js.map +1 -0
- package/dist/server/bootstrap.d.ts +6 -0
- package/dist/server/bootstrap.d.ts.map +1 -1
- package/dist/server/bootstrap.js +18 -1
- package/dist/server/bootstrap.js.map +1 -1
- package/dist/testing/context.d.ts +3 -0
- package/dist/testing/context.d.ts.map +1 -1
- package/dist/testing/context.js +10 -0
- package/dist/testing/context.js.map +1 -1
- package/dist/testing/simulate-flow.d.ts.map +1 -1
- package/dist/testing/simulate-flow.js +10 -0
- package/dist/testing/simulate-flow.js.map +1 -1
- package/dist/types/capability.d.ts +8 -0
- package/dist/types/capability.d.ts.map +1 -1
- package/dist/types/capability.js.map +1 -1
- package/dist/types/config.d.ts +2 -0
- package/dist/types/config.d.ts.map +1 -1
- package/dist/types/context.d.ts +34 -1
- package/dist/types/context.d.ts.map +1 -1
- package/dist/types/enums.d.ts +1 -0
- package/dist/types/enums.d.ts.map +1 -1
- package/dist/types/enums.js +1 -0
- package/dist/types/enums.js.map +1 -1
- package/dist/types/errors.d.ts +1 -0
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/event.d.ts +10 -0
- package/dist/types/event.d.ts.map +1 -1
- package/dist/types/event.js +5 -1
- package/dist/types/event.js.map +1 -1
- package/dist/worker/bootstrap.d.ts +32 -1
- package/dist/worker/bootstrap.d.ts.map +1 -1
- package/dist/worker/bootstrap.js +166 -2
- package/dist/worker/bootstrap.js.map +1 -1
- package/instructions/capabilities.md +36 -1
- package/instructions/deployment.md +96 -11
- package/instructions/events.md +11 -0
- package/instructions/flows.md +12 -4
- package/instructions/governance.md +6 -0
- package/instructions/mcp.md +1 -1
- package/instructions/patterns.md +1 -0
- package/instructions/security.md +9 -0
- package/instructions/testing.md +12 -1
- package/instructions/upgrading-0.5-capabilities.md +181 -0
- package/package.json +12 -4
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
// ── Capability dependency governance rules ──
|
|
2
|
+
import { getCanonicalCapabilityName, isCanonicalCapabilityName, } from '../../execution/canonical-name.js';
|
|
3
|
+
import { CapabilityKind, FlowStepType, GovernanceSeverity } from '../../types/enums.js';
|
|
4
|
+
const DEEP_CHAIN_THRESHOLD = 3;
|
|
5
|
+
function buildDeclaredGraph(capabilities) {
|
|
6
|
+
const graph = new Map();
|
|
7
|
+
for (const cap of capabilities) {
|
|
8
|
+
graph.set(getCanonicalCapabilityName(cap), cap.effects.capabilities ?? []);
|
|
9
|
+
}
|
|
10
|
+
return graph;
|
|
11
|
+
}
|
|
12
|
+
function registeredCanonicalNames(capabilities) {
|
|
13
|
+
return new Set(capabilities.map((c) => getCanonicalCapabilityName(c)));
|
|
14
|
+
}
|
|
15
|
+
function maxDeclaredDepth(graph, start) {
|
|
16
|
+
const visited = new Set();
|
|
17
|
+
function dfs(node) {
|
|
18
|
+
if (visited.has(node))
|
|
19
|
+
return 0;
|
|
20
|
+
visited.add(node);
|
|
21
|
+
const deps = graph.get(node) ?? [];
|
|
22
|
+
if (deps.length === 0)
|
|
23
|
+
return 1;
|
|
24
|
+
return 1 + Math.max(...deps.map((d) => dfs(d)));
|
|
25
|
+
}
|
|
26
|
+
return dfs(start);
|
|
27
|
+
}
|
|
28
|
+
function findDeclaredCycle(graph) {
|
|
29
|
+
const visiting = new Set();
|
|
30
|
+
const visited = new Set();
|
|
31
|
+
const stack = [];
|
|
32
|
+
function dfs(node) {
|
|
33
|
+
if (visiting.has(node)) {
|
|
34
|
+
const cycleStart = stack.indexOf(node);
|
|
35
|
+
return cycleStart >= 0 ? [...stack.slice(cycleStart), node] : [node, node];
|
|
36
|
+
}
|
|
37
|
+
if (visited.has(node))
|
|
38
|
+
return null;
|
|
39
|
+
visiting.add(node);
|
|
40
|
+
stack.push(node);
|
|
41
|
+
for (const dep of graph.get(node) ?? []) {
|
|
42
|
+
const cycle = dfs(dep);
|
|
43
|
+
if (cycle)
|
|
44
|
+
return cycle;
|
|
45
|
+
}
|
|
46
|
+
stack.pop();
|
|
47
|
+
visiting.delete(node);
|
|
48
|
+
visited.add(node);
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
for (const node of graph.keys()) {
|
|
52
|
+
const cycle = dfs(node);
|
|
53
|
+
if (cycle)
|
|
54
|
+
return cycle;
|
|
55
|
+
}
|
|
56
|
+
return null;
|
|
57
|
+
}
|
|
58
|
+
export const ruleMissingCapabilityDependency = {
|
|
59
|
+
id: 'architecture.missing-capability-dependency',
|
|
60
|
+
category: 'architecture',
|
|
61
|
+
severity: GovernanceSeverity.Warning,
|
|
62
|
+
description: 'Declared capability dependencies must reference registered capabilities',
|
|
63
|
+
evaluate(inventory) {
|
|
64
|
+
const registered = registeredCanonicalNames(inventory.capabilities);
|
|
65
|
+
const signals = [];
|
|
66
|
+
for (const cap of inventory.capabilities) {
|
|
67
|
+
for (const dep of cap.effects.capabilities ?? []) {
|
|
68
|
+
if (!registered.has(dep)) {
|
|
69
|
+
signals.push({
|
|
70
|
+
severity: GovernanceSeverity.Warning,
|
|
71
|
+
rule: 'architecture.missing-capability-dependency',
|
|
72
|
+
description: `Capability "${getCanonicalCapabilityName(cap)}" declares dependency "${dep}" which is not registered`,
|
|
73
|
+
affectedComponent: `capability:${getCanonicalCapabilityName(cap)}`,
|
|
74
|
+
remediation: `Register capability "${dep}" or remove it from effects.capabilities`,
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
return signals;
|
|
80
|
+
},
|
|
81
|
+
};
|
|
82
|
+
export const ruleCircularCapabilityDependency = {
|
|
83
|
+
id: 'architecture.circular-capability-dependency',
|
|
84
|
+
category: 'architecture',
|
|
85
|
+
severity: GovernanceSeverity.Warning,
|
|
86
|
+
description: 'Declared capability dependency graph must not contain cycles',
|
|
87
|
+
evaluate(inventory) {
|
|
88
|
+
const graph = buildDeclaredGraph(inventory.capabilities);
|
|
89
|
+
const cycle = findDeclaredCycle(graph);
|
|
90
|
+
if (!cycle)
|
|
91
|
+
return [];
|
|
92
|
+
return [
|
|
93
|
+
{
|
|
94
|
+
severity: GovernanceSeverity.Warning,
|
|
95
|
+
rule: 'architecture.circular-capability-dependency',
|
|
96
|
+
description: `Circular capability dependency detected: ${cycle.join(' -> ')}`,
|
|
97
|
+
affectedComponent: `capability:${cycle[0] ?? 'unknown'}`,
|
|
98
|
+
remediation: 'Break the cycle by extracting shared logic or using a flow for orchestration',
|
|
99
|
+
},
|
|
100
|
+
];
|
|
101
|
+
},
|
|
102
|
+
};
|
|
103
|
+
export const ruleDeepCapabilityChain = {
|
|
104
|
+
id: 'architecture.deep-capability-chain',
|
|
105
|
+
category: 'architecture',
|
|
106
|
+
severity: GovernanceSeverity.Info,
|
|
107
|
+
description: 'Deep declared capability chains may be better modeled as flows',
|
|
108
|
+
evaluate(inventory) {
|
|
109
|
+
const graph = buildDeclaredGraph(inventory.capabilities);
|
|
110
|
+
return inventory.capabilities
|
|
111
|
+
.filter((cap) => {
|
|
112
|
+
const canonical = getCanonicalCapabilityName(cap);
|
|
113
|
+
return maxDeclaredDepth(graph, canonical) >= DEEP_CHAIN_THRESHOLD;
|
|
114
|
+
})
|
|
115
|
+
.map((cap) => ({
|
|
116
|
+
severity: GovernanceSeverity.Info,
|
|
117
|
+
rule: 'architecture.deep-capability-chain',
|
|
118
|
+
description: `Capability "${getCanonicalCapabilityName(cap)}" has a declared dependency chain depth >= ${DEEP_CHAIN_THRESHOLD}`,
|
|
119
|
+
affectedComponent: `capability:${getCanonicalCapabilityName(cap)}`,
|
|
120
|
+
remediation: 'Consider a flow for multi-step orchestration instead of deep nested invocation',
|
|
121
|
+
}));
|
|
122
|
+
},
|
|
123
|
+
};
|
|
124
|
+
export const ruleNonCanonicalCapabilityReference = {
|
|
125
|
+
id: 'architecture.non-canonical-capability-reference',
|
|
126
|
+
category: 'architecture',
|
|
127
|
+
severity: GovernanceSeverity.Warning,
|
|
128
|
+
description: 'Capability references must use canonical <domain>.<name> format',
|
|
129
|
+
evaluate(inventory) {
|
|
130
|
+
const signals = [];
|
|
131
|
+
for (const cap of inventory.capabilities) {
|
|
132
|
+
for (const dep of cap.effects.capabilities ?? []) {
|
|
133
|
+
if (!isCanonicalCapabilityName(dep)) {
|
|
134
|
+
signals.push({
|
|
135
|
+
severity: GovernanceSeverity.Warning,
|
|
136
|
+
rule: 'architecture.non-canonical-capability-reference',
|
|
137
|
+
description: `Capability "${getCanonicalCapabilityName(cap)}" references non-canonical dependency "${dep}"`,
|
|
138
|
+
affectedComponent: `capability:${getCanonicalCapabilityName(cap)}`,
|
|
139
|
+
remediation: 'Use canonical format <domain>.<capabilityName> in effects.capabilities',
|
|
140
|
+
});
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
for (const flow of inventory.flows) {
|
|
145
|
+
for (const step of flow.steps) {
|
|
146
|
+
if (step.type === FlowStepType.Capability && step.capability) {
|
|
147
|
+
if (!isCanonicalCapabilityName(step.capability)) {
|
|
148
|
+
signals.push({
|
|
149
|
+
severity: GovernanceSeverity.Warning,
|
|
150
|
+
rule: 'architecture.non-canonical-capability-reference',
|
|
151
|
+
description: `Flow "${flow.name}" step "${step.name}" references non-canonical capability "${step.capability}"`,
|
|
152
|
+
affectedComponent: `flow:${flow.name}`,
|
|
153
|
+
remediation: 'Use canonical format <domain>.<capabilityName> in flow step.capability',
|
|
154
|
+
});
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
return signals;
|
|
160
|
+
},
|
|
161
|
+
};
|
|
162
|
+
export const ruleJobCapabilityDependency = {
|
|
163
|
+
id: 'architecture.job-capability-dependency',
|
|
164
|
+
category: 'architecture',
|
|
165
|
+
severity: GovernanceSeverity.Warning,
|
|
166
|
+
description: 'Job capabilities cannot be invoked synchronously via ctx.capabilities.invoke',
|
|
167
|
+
evaluate(inventory) {
|
|
168
|
+
const jobNames = new Set(inventory.capabilities
|
|
169
|
+
.filter((c) => c.kind === CapabilityKind.Job)
|
|
170
|
+
.map((c) => getCanonicalCapabilityName(c)));
|
|
171
|
+
const signals = [];
|
|
172
|
+
for (const cap of inventory.capabilities) {
|
|
173
|
+
for (const dep of cap.effects.capabilities ?? []) {
|
|
174
|
+
if (jobNames.has(dep)) {
|
|
175
|
+
signals.push({
|
|
176
|
+
severity: GovernanceSeverity.Warning,
|
|
177
|
+
rule: 'architecture.job-capability-dependency',
|
|
178
|
+
description: `Capability "${getCanonicalCapabilityName(cap)}" declares job capability "${dep}" as a synchronous dependency`,
|
|
179
|
+
affectedComponent: `capability:${getCanonicalCapabilityName(cap)}`,
|
|
180
|
+
remediation: 'Use job dispatch, flows, or events instead of nested invoke for job capabilities',
|
|
181
|
+
});
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
return signals;
|
|
186
|
+
},
|
|
187
|
+
};
|
|
188
|
+
export const capabilityDependencyRules = [
|
|
189
|
+
ruleMissingCapabilityDependency,
|
|
190
|
+
ruleCircularCapabilityDependency,
|
|
191
|
+
ruleDeepCapabilityChain,
|
|
192
|
+
ruleNonCanonicalCapabilityReference,
|
|
193
|
+
ruleJobCapabilityDependency,
|
|
194
|
+
];
|
|
195
|
+
//# sourceMappingURL=capability-dependencies.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capability-dependencies.js","sourceRoot":"","sources":["../../../src/governance/rules/capability-dependencies.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,6 +2,8 @@ export { aiRules, ruleAIWithoutExplanation, ruleExcessiveAIUsage, rulePromptMiss
|
|
|
2
2
|
export { apiRules, ruleApiDeprecatedWithoutReplacement, ruleApiMetadataWithoutExposure, ruleApiMissingAuth, ruleApiMissingOperationId, ruleApiPublicMutationWithoutIdempotency, } from './api.js';
|
|
3
3
|
export { mcpRules, ruleMcpMissingDescription } from './mcp.js';
|
|
4
4
|
export { architectureRules, ruleEntityMissingDescription, ruleExcessiveEffects, ruleExcessiveFlowBranching, ruleExcessiveFlowSteps, ruleMissingAuditConfig, } from './architecture.js';
|
|
5
|
+
export { capabilityDependencyRules, ruleCircularCapabilityDependency, ruleDeepCapabilityChain, ruleJobCapabilityDependency, ruleMissingCapabilityDependency, ruleNonCanonicalCapabilityReference, } from './capability-dependencies.js';
|
|
5
6
|
export { privacyRules, ruleExcessiveDataRetention, ruleMissingFieldClassification, rulePersonalDataInLogs, ruleSensitiveFieldUnencrypted, } from './privacy.js';
|
|
6
7
|
export { ruleCapabilityMissingAccessPolicy, ruleCrossTenantDataAccess, ruleEntityTenantIsolation, ruleOverlyPermissiveRoles, securityRules, } from './security.js';
|
|
8
|
+
export { ruleEventHandlerMissingTrigger, ruleEventHandlerSideEffects, workerRules, } from './worker.js';
|
|
7
9
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/governance/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,QAAQ,EACR,mCAAmC,EACnC,8BAA8B,EAC9B,kBAAkB,EAClB,yBAAyB,EACzB,uCAAuC,GACxC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,GACd,MAAM,eAAe,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/governance/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,QAAQ,EACR,mCAAmC,EACnC,8BAA8B,EAC9B,kBAAkB,EAClB,yBAAyB,EACzB,uCAAuC,GACxC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,mCAAmC,GACpC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,WAAW,GACZ,MAAM,aAAa,CAAC"}
|
|
@@ -3,6 +3,8 @@ export { aiRules, ruleAIWithoutExplanation, ruleExcessiveAIUsage, rulePromptMiss
|
|
|
3
3
|
export { apiRules, ruleApiDeprecatedWithoutReplacement, ruleApiMetadataWithoutExposure, ruleApiMissingAuth, ruleApiMissingOperationId, ruleApiPublicMutationWithoutIdempotency, } from './api.js';
|
|
4
4
|
export { mcpRules, ruleMcpMissingDescription } from './mcp.js';
|
|
5
5
|
export { architectureRules, ruleEntityMissingDescription, ruleExcessiveEffects, ruleExcessiveFlowBranching, ruleExcessiveFlowSteps, ruleMissingAuditConfig, } from './architecture.js';
|
|
6
|
+
export { capabilityDependencyRules, ruleCircularCapabilityDependency, ruleDeepCapabilityChain, ruleJobCapabilityDependency, ruleMissingCapabilityDependency, ruleNonCanonicalCapabilityReference, } from './capability-dependencies.js';
|
|
6
7
|
export { privacyRules, ruleExcessiveDataRetention, ruleMissingFieldClassification, rulePersonalDataInLogs, ruleSensitiveFieldUnencrypted, } from './privacy.js';
|
|
7
8
|
export { ruleCapabilityMissingAccessPolicy, ruleCrossTenantDataAccess, ruleEntityTenantIsolation, ruleOverlyPermissiveRoles, securityRules, } from './security.js';
|
|
9
|
+
export { ruleEventHandlerMissingTrigger, ruleEventHandlerSideEffects, workerRules, } from './worker.js';
|
|
8
10
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/governance/rules/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EACL,OAAO,EACP,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,QAAQ,EACR,mCAAmC,EACnC,8BAA8B,EAC9B,kBAAkB,EAClB,yBAAyB,EACzB,uCAAuC,GACxC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,GACd,MAAM,eAAe,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/governance/rules/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EACL,OAAO,EACP,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,QAAQ,EACR,mCAAmC,EACnC,8BAA8B,EAC9B,kBAAkB,EAClB,yBAAyB,EACzB,uCAAuC,GACxC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,mCAAmC,GACpC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,WAAW,GACZ,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { GovernanceRule } from '../rule-engine.js';
|
|
2
|
+
/** Warn when eventHandler capabilities lack trigger.event (no auto-registration). */
|
|
3
|
+
export declare const ruleEventHandlerMissingTrigger: GovernanceRule;
|
|
4
|
+
/** Warn eventHandlers with data/event side effects about at-least-once delivery idempotency. */
|
|
5
|
+
export declare const ruleEventHandlerSideEffects: GovernanceRule;
|
|
6
|
+
/** Advisory: handler input schema should be compatible with event payload schema. */
|
|
7
|
+
export declare const ruleEventHandlerPayloadCompatibility: GovernanceRule;
|
|
8
|
+
export declare const workerRules: GovernanceRule[];
|
|
9
|
+
//# sourceMappingURL=worker.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/governance/rules/worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASxD,qFAAqF;AACrF,eAAO,MAAM,8BAA8B,EAAE,cAiB5C,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,2BAA2B,EAAE,cAsBzC,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,oCAAoC,EAAE,cAsClD,CAAC;AAEF,eAAO,MAAM,WAAW,kBAIvB,CAAC"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
// ── Worker / queue governance rules ──
|
|
2
|
+
import { z } from 'zod';
|
|
3
|
+
import { CapabilityKind, GovernanceSeverity } from '../../types/enums.js';
|
|
4
|
+
function zodObjectKeys(schema) {
|
|
5
|
+
if (schema instanceof z.ZodObject) {
|
|
6
|
+
return new Set(Object.keys(schema.shape));
|
|
7
|
+
}
|
|
8
|
+
return null;
|
|
9
|
+
}
|
|
10
|
+
/** Warn when eventHandler capabilities lack trigger.event (no auto-registration). */
|
|
11
|
+
export const ruleEventHandlerMissingTrigger = {
|
|
12
|
+
id: 'worker.event-handler-missing-trigger',
|
|
13
|
+
category: 'architecture',
|
|
14
|
+
severity: GovernanceSeverity.Warning,
|
|
15
|
+
description: 'eventHandler capabilities should declare trigger.event for auto-registration',
|
|
16
|
+
evaluate(inventory) {
|
|
17
|
+
return inventory.capabilities
|
|
18
|
+
.filter((cap) => cap.kind === CapabilityKind.EventHandler && !cap.trigger?.event)
|
|
19
|
+
.map((cap) => ({
|
|
20
|
+
severity: GovernanceSeverity.Warning,
|
|
21
|
+
rule: 'worker.event-handler-missing-trigger',
|
|
22
|
+
description: `eventHandler "${cap.name}" has no trigger.event — it will not auto-register`,
|
|
23
|
+
affectedComponent: `capability:${cap.name}`,
|
|
24
|
+
remediation: 'Add `trigger: { event: "your.event" }` or register a ConsumerRegistry handler in app/server.ts',
|
|
25
|
+
}));
|
|
26
|
+
},
|
|
27
|
+
};
|
|
28
|
+
/** Warn eventHandlers with data/event side effects about at-least-once delivery idempotency. */
|
|
29
|
+
export const ruleEventHandlerSideEffects = {
|
|
30
|
+
id: 'worker.event-handler-side-effects',
|
|
31
|
+
category: 'architecture',
|
|
32
|
+
severity: GovernanceSeverity.Info,
|
|
33
|
+
description: 'eventHandler capabilities with write effects should be idempotent (at-least-once delivery)',
|
|
34
|
+
evaluate(inventory) {
|
|
35
|
+
return inventory.capabilities
|
|
36
|
+
.filter((cap) => cap.kind === CapabilityKind.EventHandler &&
|
|
37
|
+
((cap.effects?.data?.length ?? 0) > 0 || (cap.effects?.events?.length ?? 0) > 0))
|
|
38
|
+
.map((cap) => ({
|
|
39
|
+
severity: GovernanceSeverity.Info,
|
|
40
|
+
rule: 'worker.event-handler-side-effects',
|
|
41
|
+
description: `eventHandler "${cap.name}" mutates data/events — ensure handler logic is idempotent`,
|
|
42
|
+
affectedComponent: `capability:${cap.name}`,
|
|
43
|
+
remediation: 'Design handlers to tolerate duplicate delivery (natural keys, upserts, or idempotency checks)',
|
|
44
|
+
}));
|
|
45
|
+
},
|
|
46
|
+
};
|
|
47
|
+
/** Advisory: handler input schema should be compatible with event payload schema. */
|
|
48
|
+
export const ruleEventHandlerPayloadCompatibility = {
|
|
49
|
+
id: 'worker.event-handler-payload-compatibility',
|
|
50
|
+
category: 'architecture',
|
|
51
|
+
severity: GovernanceSeverity.Warning,
|
|
52
|
+
description: 'eventHandler input schema should align with the triggered event payload schema',
|
|
53
|
+
evaluate(inventory) {
|
|
54
|
+
const eventByName = new Map(inventory.events.map((evt) => [evt.name, evt]));
|
|
55
|
+
const signals = [];
|
|
56
|
+
for (const cap of inventory.capabilities) {
|
|
57
|
+
if (cap.kind !== CapabilityKind.EventHandler || !cap.trigger?.event) {
|
|
58
|
+
continue;
|
|
59
|
+
}
|
|
60
|
+
const eventDef = eventByName.get(cap.trigger.event);
|
|
61
|
+
if (!eventDef) {
|
|
62
|
+
continue;
|
|
63
|
+
}
|
|
64
|
+
const handlerKeys = zodObjectKeys(cap.input);
|
|
65
|
+
const eventKeys = zodObjectKeys(eventDef.payload);
|
|
66
|
+
if (!handlerKeys || !eventKeys) {
|
|
67
|
+
continue;
|
|
68
|
+
}
|
|
69
|
+
const missingOnEvent = [...handlerKeys].filter((key) => !eventKeys.has(key));
|
|
70
|
+
if (missingOnEvent.length === 0) {
|
|
71
|
+
continue;
|
|
72
|
+
}
|
|
73
|
+
signals.push({
|
|
74
|
+
severity: GovernanceSeverity.Warning,
|
|
75
|
+
rule: 'worker.event-handler-payload-compatibility',
|
|
76
|
+
description: `eventHandler "${cap.name}" expects input keys [${missingOnEvent.join(', ')}] not present on event "${cap.trigger.event}" payload`,
|
|
77
|
+
affectedComponent: `capability:${cap.name}`,
|
|
78
|
+
remediation: 'Align handler input with the event payload schema, or narrow handler input to a subset of event fields',
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
return signals;
|
|
82
|
+
},
|
|
83
|
+
};
|
|
84
|
+
export const workerRules = [
|
|
85
|
+
ruleEventHandlerMissingTrigger,
|
|
86
|
+
ruleEventHandlerSideEffects,
|
|
87
|
+
ruleEventHandlerPayloadCompatibility,
|
|
88
|
+
];
|
|
89
|
+
//# sourceMappingURL=worker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/governance/rules/worker.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -22,7 +22,8 @@ export { PlumbusError, LeaseLostError, createErrorService, isPlumbusError, } fro
|
|
|
22
22
|
export type { DispatcherConfig, EventConsumer, EventConsumerHandler, EventEmitterConfig, EventQueue, IdempotencyService, RedisClient, RedisQueueConfig, WorkerConfig, } from './events/index.js';
|
|
23
23
|
export { ConsumerRegistry, EventRegistry, createEventEmitter, createEventWorker, createIdempotencyService, createInMemoryQueue, createOutboxDispatcher, createRedisQueue, deadLetterTable, idempotencyTable, outboxTable, } from './events/index.js';
|
|
24
24
|
export type { AuthorizationResult, CapabilityResult, ContextDependencies, ExecutionFailure, ExecutionResult, } from './execution/index.js';
|
|
25
|
-
export { CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, } from './execution/index.js';
|
|
25
|
+
export { buildCapabilityRuntimeDeps, CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, getCanonicalCapabilityName, isCanonicalCapabilityName, } from './execution/index.js';
|
|
26
|
+
export type { DependencyViolationMetadata, DependencyViolationReason, } from './execution/index.js';
|
|
26
27
|
export type { AIInvocationExplanation, AuthorizationExplanation, ExplanationFilter, ExplanationRecord, ExplanationTracker, ExplanationTrackerConfig, ExplanationType, FlowBranchExplanation, GovernanceExplanation, } from './explanation/index.js';
|
|
27
28
|
export { createExplanationTracker } from './explanation/index.js';
|
|
28
29
|
export { field } from './fields/index.js';
|
|
@@ -36,6 +37,10 @@ export { TranslationRegistry, createTranslationResolver, createTranslationServic
|
|
|
36
37
|
export * from './types/index.js';
|
|
37
38
|
export type { WorkerPool, WorkerPoolConfig } from './worker/index.js';
|
|
38
39
|
export { createWorkerPool } from './worker/index.js';
|
|
40
|
+
export type { BuildWorkerAiServiceOptions, RegisterCapabilityConsumersOptions, ResolveRuntimeQueuesOptions, RuntimeCommand, RuntimeQueues, ServerExtensions, } from './runtime/index.js';
|
|
41
|
+
export { RuntimeRole, buildStepDeps, buildWorkerAiService, discoverRuntimeResources, needsWorkerPool, registerCapabilityConsumers, resolveRuntimeQueues, resolveRuntimeRole, shouldStartApiServer, shouldStartWorkerPool, shouldUseRedisBackend, tryCreateRedisClient, } from './runtime/index.js';
|
|
42
|
+
export type { CreateJobExecutionInput, DispatchJobOptions, JobExecutionRecord, JobQueuePayload, JobService, } from './jobs/index.js';
|
|
43
|
+
export { JobExecutionSource, JobExecutionStatus, createJobService, dispatchQueuedJob, jobEventType, jobExecutionsTable, registerJobStatusRoute, } from './jobs/index.js';
|
|
39
44
|
export type { AgentFormat, CreateOptions, DevOptions, DoctorCheck, InitOptions, PolicyContext, PolicyRule, } from './cli/index.js';
|
|
40
45
|
export { assertInsidePlumbusProject, capabilityTemplate, capabilityTestTemplate, checkAppStructure, checkConfig, checkLegacyArtifacts, checkNodeVersion, checkPackageJson, checkPlumbusCore, checkPlumbusUi, checkPostgreSQL, checkRedis, checkTypeScript, commandRequiresProject, createCli, entityTemplate, evaluatePolicy, eventTemplate, findPlumbusProjectRoot, flowTemplate, generateAgentsMd, generateAll, generateCapabilityBrief, generateCapabilityNameType, generateCapabilityTypes, generateClientFunction, generateCopilotInstructions, generateCursorCapabilityRule, generateCursorRule, generateDataServiceMap, generateEntityBrief, generateEntityInterface, generateEntityTypeFile, generateManifestEntry, generateOpenApiPath, generateProjectBrief, generateProjectBriefFromResources, generateProjectStructure, generateReactHook, promptTemplate, ruleCapabilityAccessPolicy, ruleCapabilityEffects, ruleEncryptedSensitiveFields, ruleEntityFieldClassification, ruleEntityTenantIsolation, runDev, runDoctorChecks, runFullDoctorChecks, runGovernanceRules, startDevServer, toCamelCase, toKebabCase, toPascalCase, translationTemplate, writeAgentFiles, zodTypeToString, } from './cli/index.js';
|
|
41
46
|
export type { GovernanceResult, GovernanceRule, GovernanceRuleEngine, OverrideEntry, OverrideStore, PolicyProfileDefinition, PolicyProfileRule, ReportOptions, RuleCategory, SystemInventory, } from './governance/index.js';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -39,7 +39,7 @@ export { PlumbusError, LeaseLostError, createErrorService, isPlumbusError, } fro
|
|
|
39
39
|
// ── Events ──
|
|
40
40
|
export { ConsumerRegistry, EventRegistry, createEventEmitter, createEventWorker, createIdempotencyService, createInMemoryQueue, createOutboxDispatcher, createRedisQueue, deadLetterTable, idempotencyTable, outboxTable, } from './events/index.js';
|
|
41
41
|
// ── Execution Engine ──
|
|
42
|
-
export { CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, } from './execution/index.js';
|
|
42
|
+
export { buildCapabilityRuntimeDeps, CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, getCanonicalCapabilityName, isCanonicalCapabilityName, } from './execution/index.js';
|
|
43
43
|
// ── Explanation ──
|
|
44
44
|
export { createExplanationTracker } from './explanation/index.js';
|
|
45
45
|
// ── Field Constructors ──
|
|
@@ -56,6 +56,8 @@ export { TranslationRegistry, createTranslationResolver, createTranslationServic
|
|
|
56
56
|
export * from './types/index.js';
|
|
57
57
|
// ── Worker Bootstrap ──
|
|
58
58
|
export { createWorkerPool } from './worker/index.js';
|
|
59
|
+
export { RuntimeRole, buildStepDeps, buildWorkerAiService, discoverRuntimeResources, needsWorkerPool, registerCapabilityConsumers, resolveRuntimeQueues, resolveRuntimeRole, shouldStartApiServer, shouldStartWorkerPool, shouldUseRedisBackend, tryCreateRedisClient, } from './runtime/index.js';
|
|
60
|
+
export { JobExecutionSource, JobExecutionStatus, createJobService, dispatchQueuedJob, jobEventType, jobExecutionsTable, registerJobStatusRoute, } from './jobs/index.js';
|
|
59
61
|
// ── CLI (entry point + scaffolding + code generation) ──
|
|
60
62
|
export {
|
|
61
63
|
// CLI project guard
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4BAA4B;AAC5B,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,qDAAqD;AACrD,wEAAwE;AACxE,0EAA0E;AAC1E,EAAE;AACF,6DAA6D;AAC7D,4EAA4E;AAC5E,2DAA2D;AAC3D,EAAE;AACF,2DAA2D;AAC3D,+EAA+E;AAmD/E,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,oCAAoC;AACpC,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAmBpE,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE/D,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,GAAG,EACH,KAAK,EACL,IAAI,EACJ,GAAG,EACH,qBAAqB,EACrB,GAAG,GACJ,MAAM,iBAAiB,CAAC;AACzB,yBAAyB;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAY3B,eAAe;AACf,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAQ3B,yBAAyB;AACzB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
|
|
2
|
+
import type { CapabilityContract } from '../types/capability.js';
|
|
3
|
+
import type { EventQueue } from '../events/queue.js';
|
|
4
|
+
import type { AuthContext } from '../types/security.js';
|
|
5
|
+
import { JobExecutionSource } from './schema.js';
|
|
6
|
+
export interface DispatchJobOptions {
|
|
7
|
+
db: PostgresJsDatabase;
|
|
8
|
+
jobQueue: EventQueue;
|
|
9
|
+
capability: CapabilityContract;
|
|
10
|
+
input: Record<string, unknown>;
|
|
11
|
+
auth: AuthContext;
|
|
12
|
+
jobId?: string;
|
|
13
|
+
source?: (typeof JobExecutionSource)[keyof typeof JobExecutionSource];
|
|
14
|
+
correlationId?: string;
|
|
15
|
+
}
|
|
16
|
+
/** Create job_executions row and publish to the jobs queue. */
|
|
17
|
+
export declare function dispatchQueuedJob(options: DispatchJobOptions): Promise<string>;
|
|
18
|
+
//# sourceMappingURL=dispatch.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/jobs/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,kBAAkB,CAAC;IACvB,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDpF"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { evaluateAccess } from '../execution/authorization.js';
|
|
2
|
+
import { createJobService } from './service.js';
|
|
3
|
+
import { JobExecutionSource } from './schema.js';
|
|
4
|
+
import { jobEventType } from './types.js';
|
|
5
|
+
/** Create job_executions row and publish to the jobs queue. */
|
|
6
|
+
export async function dispatchQueuedJob(options) {
|
|
7
|
+
const { db, jobQueue, capability, input, auth, jobId = crypto.randomUUID(), source = JobExecutionSource.Http, correlationId, } = options;
|
|
8
|
+
if (capability.kind !== 'job') {
|
|
9
|
+
throw new Error(`Capability "${capability.name}" is not kind job`);
|
|
10
|
+
}
|
|
11
|
+
const authz = evaluateAccess(capability.access, auth);
|
|
12
|
+
if (!authz.allowed) {
|
|
13
|
+
throw new Error(authz.reason ?? 'Job access denied at enqueue');
|
|
14
|
+
}
|
|
15
|
+
const jobs = createJobService(db);
|
|
16
|
+
await jobs.create({
|
|
17
|
+
id: jobId,
|
|
18
|
+
capabilityDomain: capability.domain,
|
|
19
|
+
capabilityName: capability.name,
|
|
20
|
+
input,
|
|
21
|
+
auth,
|
|
22
|
+
correlationId: correlationId ?? jobId,
|
|
23
|
+
source,
|
|
24
|
+
});
|
|
25
|
+
const payload = {
|
|
26
|
+
input,
|
|
27
|
+
capability: { domain: capability.domain, name: capability.name },
|
|
28
|
+
jobExecutionId: jobId,
|
|
29
|
+
source,
|
|
30
|
+
};
|
|
31
|
+
try {
|
|
32
|
+
await jobQueue.publish({
|
|
33
|
+
id: jobId,
|
|
34
|
+
eventType: jobEventType(capability.domain, capability.name),
|
|
35
|
+
version: '1',
|
|
36
|
+
occurredAt: new Date(),
|
|
37
|
+
actor: auth.userId ?? 'anonymous',
|
|
38
|
+
tenantId: auth.tenantId,
|
|
39
|
+
correlationId: correlationId ?? jobId,
|
|
40
|
+
payload,
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
catch (err) {
|
|
44
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
45
|
+
await jobs.markPublishFailed(jobId, { code: 'queue_publish_failed', message });
|
|
46
|
+
throw err;
|
|
47
|
+
}
|
|
48
|
+
return jobId;
|
|
49
|
+
}
|
|
50
|
+
//# sourceMappingURL=dispatch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/jobs/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAI/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAwB,MAAM,YAAY,CAAC;AAahE,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA2B;IACjE,MAAM,EACJ,EAAE,EACF,QAAQ,EACR,UAAU,EACV,KAAK,EACL,IAAI,EACJ,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,EAC3B,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAChC,aAAa,GACd,GAAG,OAAO,CAAC;IAEZ,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,CAAC,IAAI,mBAAmB,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,8BAA8B,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,IAAI,CAAC,MAAM,CAAC;QAChB,EAAE,EAAE,KAAK;QACT,gBAAgB,EAAE,UAAU,CAAC,MAAM;QACnC,cAAc,EAAE,UAAU,CAAC,IAAI;QAC/B,KAAK;QACL,IAAI;QACJ,aAAa,EAAE,aAAa,IAAI,KAAK;QACrC,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,OAAO,GAAoB;QAC/B,KAAK;QACL,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE;QAChE,cAAc,EAAE,KAAK;QACrB,MAAM;KACP,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC;YACrB,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC;YAC3D,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,IAAI,IAAI,EAAE;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,WAAW;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,aAAa,IAAI,KAAK;YACrC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export { dispatchQueuedJob } from './dispatch.js';
|
|
2
|
+
export type { DispatchJobOptions } from './dispatch.js';
|
|
3
|
+
export { createJobService } from './service.js';
|
|
4
|
+
export type { CreateJobExecutionInput, JobService } from './service.js';
|
|
5
|
+
export { jobExecutionsTable, JobExecutionSource, JobExecutionStatus, } from './schema.js';
|
|
6
|
+
export { jobEventType } from './types.js';
|
|
7
|
+
export type { JobExecutionRecord, JobQueuePayload } from './types.js';
|
|
8
|
+
export { registerJobStatusRoute } from './routes.js';
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
// ── Jobs Module ──
|
|
2
|
+
// Async capability job persistence and queue envelope types.
|
|
3
|
+
export { dispatchQueuedJob } from './dispatch.js';
|
|
4
|
+
export { createJobService } from './service.js';
|
|
5
|
+
export { jobExecutionsTable, JobExecutionSource, JobExecutionStatus, } from './schema.js';
|
|
6
|
+
export { jobEventType } from './types.js';
|
|
7
|
+
export { registerJobStatusRoute } from './routes.js';
|
|
8
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,6DAA6D;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
|
|
2
|
+
import type { FastifyInstance } from 'fastify';
|
|
3
|
+
import type { AuthAdapter } from '../auth/adapter.js';
|
|
4
|
+
export interface JobStatusRouteConfig {
|
|
5
|
+
db: PostgresJsDatabase;
|
|
6
|
+
authAdapter: AuthAdapter;
|
|
7
|
+
}
|
|
8
|
+
/** Register GET /api/jobs/:jobId — additive job status endpoint. */
|
|
9
|
+
export declare function registerJobStatusRoute(app: FastifyInstance, config: JobStatusRouteConfig): void;
|
|
10
|
+
//# sourceMappingURL=routes.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/jobs/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,kBAAkB,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CA6C/F"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { createJobService } from './service.js';
|
|
2
|
+
/** Register GET /api/jobs/:jobId — additive job status endpoint. */
|
|
3
|
+
export function registerJobStatusRoute(app, config) {
|
|
4
|
+
const jobs = createJobService(config.db);
|
|
5
|
+
app.get('/api/jobs/:jobId', async (request, reply) => {
|
|
6
|
+
const authHeader = request.headers.authorization;
|
|
7
|
+
const auth = await config.authAdapter.authenticate(authHeader);
|
|
8
|
+
if (!auth?.userId) {
|
|
9
|
+
reply.status(401);
|
|
10
|
+
return { error: { code: 'unauthorized', message: 'Authentication required' } };
|
|
11
|
+
}
|
|
12
|
+
const { jobId } = request.params;
|
|
13
|
+
const record = await jobs.getById(jobId);
|
|
14
|
+
if (!record) {
|
|
15
|
+
reply.status(404);
|
|
16
|
+
return { error: { code: 'not_found', message: 'Job not found' } };
|
|
17
|
+
}
|
|
18
|
+
const isOwner = record.authSnapshotJson?.userId === auth.userId;
|
|
19
|
+
const isAdmin = auth.roles.includes('admin') || auth.roles.includes('system');
|
|
20
|
+
const tenantMatch = !record.tenantId || !auth.tenantId || record.tenantId === auth.tenantId;
|
|
21
|
+
if (!isOwner && !isAdmin) {
|
|
22
|
+
reply.status(403);
|
|
23
|
+
return { error: { code: 'forbidden', message: 'Access denied' } };
|
|
24
|
+
}
|
|
25
|
+
if (!tenantMatch && !isAdmin) {
|
|
26
|
+
reply.status(403);
|
|
27
|
+
return { error: { code: 'forbidden', message: 'Tenant mismatch' } };
|
|
28
|
+
}
|
|
29
|
+
return {
|
|
30
|
+
data: {
|
|
31
|
+
jobId: record.id,
|
|
32
|
+
status: record.status,
|
|
33
|
+
capability: { domain: record.capabilityDomain, name: record.capabilityName },
|
|
34
|
+
source: record.source,
|
|
35
|
+
createdAt: record.createdAt.toISOString(),
|
|
36
|
+
startedAt: record.startedAt?.toISOString() ?? null,
|
|
37
|
+
completedAt: record.completedAt?.toISOString() ?? null,
|
|
38
|
+
output: record.outputJson ?? null,
|
|
39
|
+
error: record.errorJson ?? null,
|
|
40
|
+
},
|
|
41
|
+
};
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=routes.js.map
|