@neurcode-ai/cli 0.14.0 → 0.15.1
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/LICENSE +201 -0
- package/README.md +60 -8
- package/dist/api-client.d.ts +284 -0
- package/dist/api-client.d.ts.map +1 -1
- package/dist/api-client.js +111 -0
- package/dist/api-client.js.map +1 -1
- package/dist/commands/activate.d.ts +82 -0
- package/dist/commands/activate.d.ts.map +1 -0
- package/dist/commands/activate.js +551 -0
- package/dist/commands/activate.js.map +1 -0
- package/dist/commands/admission.d.ts +67 -0
- package/dist/commands/admission.d.ts.map +1 -0
- package/dist/commands/admission.js +350 -0
- package/dist/commands/admission.js.map +1 -0
- package/dist/commands/agent.d.ts +3 -0
- package/dist/commands/agent.d.ts.map +1 -0
- package/dist/commands/agent.js +2045 -0
- package/dist/commands/agent.js.map +1 -0
- package/dist/commands/demo.d.ts +3 -0
- package/dist/commands/demo.d.ts.map +1 -0
- package/dist/commands/demo.js +102 -0
- package/dist/commands/demo.js.map +1 -0
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +58 -44
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/login.d.ts +1 -1
- package/dist/commands/login.d.ts.map +1 -1
- package/dist/commands/login.js +44 -22
- package/dist/commands/login.js.map +1 -1
- package/dist/commands/profile.d.ts +14 -0
- package/dist/commands/profile.d.ts.map +1 -0
- package/dist/commands/profile.js +118 -0
- package/dist/commands/profile.js.map +1 -0
- package/dist/commands/quickstart.d.ts +2 -2
- package/dist/commands/quickstart.d.ts.map +1 -1
- package/dist/commands/quickstart.js +31 -30
- package/dist/commands/quickstart.js.map +1 -1
- package/dist/commands/remediate-export.d.ts +6 -1
- package/dist/commands/remediate-export.d.ts.map +1 -1
- package/dist/commands/remediate-export.js +359 -7
- package/dist/commands/remediate-export.js.map +1 -1
- package/dist/commands/replay.d.ts.map +1 -1
- package/dist/commands/replay.js +84 -0
- package/dist/commands/replay.js.map +1 -1
- package/dist/commands/run.d.ts +3 -0
- package/dist/commands/run.d.ts.map +1 -0
- package/dist/commands/run.js +98 -0
- package/dist/commands/run.js.map +1 -0
- package/dist/commands/runtime-adapter.d.ts +8 -0
- package/dist/commands/runtime-adapter.d.ts.map +1 -0
- package/dist/commands/runtime-adapter.js +375 -0
- package/dist/commands/runtime-adapter.js.map +1 -0
- package/dist/commands/runtime-doctor.d.ts +6 -0
- package/dist/commands/runtime-doctor.d.ts.map +1 -0
- package/dist/commands/runtime-doctor.js +478 -0
- package/dist/commands/runtime-doctor.js.map +1 -0
- package/dist/commands/runtime-report.d.ts +13 -0
- package/dist/commands/runtime-report.d.ts.map +1 -0
- package/dist/commands/runtime-report.js +81 -0
- package/dist/commands/runtime-report.js.map +1 -0
- package/dist/commands/runtime-sync.d.ts +17 -0
- package/dist/commands/runtime-sync.d.ts.map +1 -0
- package/dist/commands/runtime-sync.js +656 -0
- package/dist/commands/runtime-sync.js.map +1 -0
- package/dist/commands/runtime.d.ts +16 -0
- package/dist/commands/runtime.d.ts.map +1 -0
- package/dist/commands/runtime.js +380 -0
- package/dist/commands/runtime.js.map +1 -0
- package/dist/commands/session-hook.d.ts +35 -0
- package/dist/commands/session-hook.d.ts.map +1 -0
- package/dist/commands/session-hook.js +1297 -0
- package/dist/commands/session-hook.js.map +1 -0
- package/dist/commands/session.d.ts +91 -0
- package/dist/commands/session.d.ts.map +1 -1
- package/dist/commands/session.js +1226 -0
- package/dist/commands/session.js.map +1 -1
- package/dist/commands/whoami.d.ts +7 -4
- package/dist/commands/whoami.d.ts.map +1 -1
- package/dist/commands/whoami.js +59 -34
- package/dist/commands/whoami.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +24 -5
- package/dist/config.js.map +1 -1
- package/dist/daemon/routes.d.ts.map +1 -1
- package/dist/daemon/routes.js +8 -0
- package/dist/daemon/routes.js.map +1 -1
- package/dist/daemon/server.d.ts.map +1 -1
- package/dist/daemon/server.js +88 -0
- package/dist/daemon/server.js.map +1 -1
- package/dist/governance/impact-analysis.d.ts +27 -0
- package/dist/governance/impact-analysis.d.ts.map +1 -0
- package/dist/governance/impact-analysis.js +274 -0
- package/dist/governance/impact-analysis.js.map +1 -0
- package/dist/index.js +472 -29
- package/dist/index.js.map +1 -1
- package/dist/intent-engine/matcher.d.ts.map +1 -1
- package/dist/intent-engine/matcher.js +3 -12
- package/dist/intent-engine/matcher.js.map +1 -1
- package/dist/utils/admission-artifact.d.ts +59 -0
- package/dist/utils/admission-artifact.d.ts.map +1 -0
- package/dist/utils/admission-artifact.js +410 -0
- package/dist/utils/admission-artifact.js.map +1 -0
- package/dist/utils/agent-adapter-setup.d.ts +80 -0
- package/dist/utils/agent-adapter-setup.d.ts.map +1 -0
- package/dist/utils/agent-adapter-setup.js +577 -0
- package/dist/utils/agent-adapter-setup.js.map +1 -0
- package/dist/utils/agent-guard-supervisor.d.ts +75 -0
- package/dist/utils/agent-guard-supervisor.d.ts.map +1 -0
- package/dist/utils/agent-guard-supervisor.js +388 -0
- package/dist/utils/agent-guard-supervisor.js.map +1 -0
- package/dist/utils/agent-guard.d.ts +92 -0
- package/dist/utils/agent-guard.d.ts.map +1 -0
- package/dist/utils/agent-guard.js +326 -0
- package/dist/utils/agent-guard.js.map +1 -0
- package/dist/utils/agent-session-launcher.d.ts +89 -0
- package/dist/utils/agent-session-launcher.d.ts.map +1 -0
- package/dist/utils/agent-session-launcher.js +308 -0
- package/dist/utils/agent-session-launcher.js.map +1 -0
- package/dist/utils/bash-command-analysis.d.ts +19 -0
- package/dist/utils/bash-command-analysis.d.ts.map +1 -0
- package/dist/utils/bash-command-analysis.js +295 -0
- package/dist/utils/bash-command-analysis.js.map +1 -0
- package/dist/utils/consequence-nudges.d.ts +30 -0
- package/dist/utils/consequence-nudges.d.ts.map +1 -0
- package/dist/utils/consequence-nudges.js +313 -0
- package/dist/utils/consequence-nudges.js.map +1 -0
- package/dist/utils/drift-intelligence.d.ts.map +1 -1
- package/dist/utils/drift-intelligence.js +29 -7
- package/dist/utils/drift-intelligence.js.map +1 -1
- package/dist/utils/git-coverage.d.ts +57 -0
- package/dist/utils/git-coverage.d.ts.map +1 -0
- package/dist/utils/git-coverage.js +302 -0
- package/dist/utils/git-coverage.js.map +1 -0
- package/dist/utils/gitignore.d.ts.map +1 -1
- package/dist/utils/gitignore.js +2 -1
- package/dist/utils/gitignore.js.map +1 -1
- package/dist/utils/governed-intent.d.ts +10 -0
- package/dist/utils/governed-intent.d.ts.map +1 -0
- package/dist/utils/governed-intent.js +108 -0
- package/dist/utils/governed-intent.js.map +1 -0
- package/dist/utils/hook-heartbeat.d.ts +55 -0
- package/dist/utils/hook-heartbeat.d.ts.map +1 -0
- package/dist/utils/hook-heartbeat.js +116 -0
- package/dist/utils/hook-heartbeat.js.map +1 -0
- package/dist/utils/intent-continuity.d.ts +21 -0
- package/dist/utils/intent-continuity.d.ts.map +1 -0
- package/dist/utils/intent-continuity.js +192 -0
- package/dist/utils/intent-continuity.js.map +1 -0
- package/dist/utils/messages.d.ts +1 -1
- package/dist/utils/messages.d.ts.map +1 -1
- package/dist/utils/messages.js +24 -21
- package/dist/utils/messages.js.map +1 -1
- package/dist/utils/runtime-companion.d.ts +137 -0
- package/dist/utils/runtime-companion.d.ts.map +1 -0
- package/dist/utils/runtime-companion.js +231 -0
- package/dist/utils/runtime-companion.js.map +1 -0
- package/dist/utils/runtime-connection.d.ts +46 -0
- package/dist/utils/runtime-connection.d.ts.map +1 -0
- package/dist/utils/runtime-connection.js +148 -0
- package/dist/utils/runtime-connection.js.map +1 -0
- package/dist/utils/runtime-evidence.d.ts +68 -0
- package/dist/utils/runtime-evidence.d.ts.map +1 -0
- package/dist/utils/runtime-evidence.js +248 -0
- package/dist/utils/runtime-evidence.js.map +1 -0
- package/dist/utils/runtime-live.d.ts +33 -0
- package/dist/utils/runtime-live.d.ts.map +1 -0
- package/dist/utils/runtime-live.js +361 -0
- package/dist/utils/runtime-live.js.map +1 -0
- package/dist/utils/runtime-outbox.d.ts +76 -0
- package/dist/utils/runtime-outbox.d.ts.map +1 -0
- package/dist/utils/runtime-outbox.js +410 -0
- package/dist/utils/runtime-outbox.js.map +1 -0
- package/dist/utils/runtime-receipt.d.ts +50 -0
- package/dist/utils/runtime-receipt.d.ts.map +1 -0
- package/dist/utils/runtime-receipt.js +223 -0
- package/dist/utils/runtime-receipt.js.map +1 -0
- package/dist/utils/state.d.ts +21 -0
- package/dist/utils/state.d.ts.map +1 -1
- package/dist/utils/state.js +30 -0
- package/dist/utils/state.js.map +1 -1
- package/dist/utils/structural-understanding.d.ts +334 -0
- package/dist/utils/structural-understanding.d.ts.map +1 -0
- package/dist/utils/structural-understanding.js +2316 -0
- package/dist/utils/structural-understanding.js.map +1 -0
- package/dist/utils/v0-governance.d.ts +197 -0
- package/dist/utils/v0-governance.d.ts.map +1 -0
- package/dist/utils/v0-governance.js +904 -0
- package/dist/utils/v0-governance.js.map +1 -0
- package/package.json +11 -12
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
export declare const AGENT_GUARD_SUPERVISOR_SCHEMA_VERSION: "neurcode.agent-guard-supervisor.v1";
|
|
2
|
+
export declare const DEFAULT_AGENT_GUARD_SUPERVISOR_DEBOUNCE_MS = 500;
|
|
3
|
+
export declare const DEFAULT_AGENT_GUARD_SUPERVISOR_HEARTBEAT_MS = 5000;
|
|
4
|
+
export type AgentGuardSupervisorStatus = 'starting' | 'running' | 'stopping' | 'stopped' | 'stale' | 'failed';
|
|
5
|
+
export interface AgentGuardSupervisorState {
|
|
6
|
+
schemaVersion: typeof AGENT_GUARD_SUPERVISOR_SCHEMA_VERSION;
|
|
7
|
+
sessionId: string;
|
|
8
|
+
guardPath: string;
|
|
9
|
+
repoRoot: string;
|
|
10
|
+
pid: number | null;
|
|
11
|
+
status: AgentGuardSupervisorStatus;
|
|
12
|
+
startedAt: string;
|
|
13
|
+
updatedAt: string;
|
|
14
|
+
heartbeatAt: string | null;
|
|
15
|
+
stoppedAt: string | null;
|
|
16
|
+
debounceMs: number;
|
|
17
|
+
heartbeatMs: number;
|
|
18
|
+
evaluationCount: number;
|
|
19
|
+
lastEvaluatedAt: string | null;
|
|
20
|
+
lastPass: boolean | null;
|
|
21
|
+
lastChangedFiles: number;
|
|
22
|
+
lastError: string | null;
|
|
23
|
+
privacy: {
|
|
24
|
+
metadataOnly: true;
|
|
25
|
+
sourceUploaded: false;
|
|
26
|
+
sourceIncluded: false;
|
|
27
|
+
watchesPathsOnly: true;
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
export interface AgentGuardSupervisorInspection {
|
|
31
|
+
statePath: string;
|
|
32
|
+
exists: boolean;
|
|
33
|
+
alive: boolean;
|
|
34
|
+
state: AgentGuardSupervisorState | null;
|
|
35
|
+
effectiveStatus: AgentGuardSupervisorStatus | 'missing';
|
|
36
|
+
error?: string;
|
|
37
|
+
}
|
|
38
|
+
export interface AgentGuardSupervisorEvaluationResult {
|
|
39
|
+
pass: boolean;
|
|
40
|
+
changedFiles: number;
|
|
41
|
+
evaluatedAt?: string;
|
|
42
|
+
}
|
|
43
|
+
export interface RunAgentGuardSupervisorOptions {
|
|
44
|
+
repoRoot: string;
|
|
45
|
+
sessionId: string;
|
|
46
|
+
guardPath: string;
|
|
47
|
+
debounceMs?: number;
|
|
48
|
+
heartbeatMs?: number;
|
|
49
|
+
exitAfterMs?: number;
|
|
50
|
+
evaluateImmediately?: boolean;
|
|
51
|
+
onEvaluate: () => Promise<AgentGuardSupervisorEvaluationResult>;
|
|
52
|
+
onState?: (state: AgentGuardSupervisorState) => void;
|
|
53
|
+
}
|
|
54
|
+
export declare function inspectAgentGuardSupervisor(repoRoot: string, sessionId: string): AgentGuardSupervisorInspection;
|
|
55
|
+
export declare function startAgentGuardSupervisorDetached(input: {
|
|
56
|
+
repoRoot: string;
|
|
57
|
+
sessionId: string;
|
|
58
|
+
guardPath: string;
|
|
59
|
+
cliEntry: string;
|
|
60
|
+
debounceMs?: number;
|
|
61
|
+
}): {
|
|
62
|
+
started: boolean;
|
|
63
|
+
alreadyRunning: boolean;
|
|
64
|
+
pid: number | null;
|
|
65
|
+
statePath: string;
|
|
66
|
+
state: AgentGuardSupervisorState;
|
|
67
|
+
};
|
|
68
|
+
export declare function stopAgentGuardSupervisor(repoRoot: string, sessionId: string): {
|
|
69
|
+
signaled: boolean;
|
|
70
|
+
statePath: string;
|
|
71
|
+
state: AgentGuardSupervisorState | null;
|
|
72
|
+
effectiveStatus: AgentGuardSupervisorInspection['effectiveStatus'];
|
|
73
|
+
};
|
|
74
|
+
export declare function runAgentGuardSupervisor(options: RunAgentGuardSupervisorOptions): Promise<AgentGuardSupervisorState>;
|
|
75
|
+
//# sourceMappingURL=agent-guard-supervisor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-guard-supervisor.d.ts","sourceRoot":"","sources":["../../src/utils/agent-guard-supervisor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,388 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
14
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
15
|
+
}) : function(o, v) {
|
|
16
|
+
o["default"] = v;
|
|
17
|
+
});
|
|
18
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
19
|
+
var ownKeys = function(o) {
|
|
20
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
21
|
+
var ar = [];
|
|
22
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
23
|
+
return ar;
|
|
24
|
+
};
|
|
25
|
+
return ownKeys(o);
|
|
26
|
+
};
|
|
27
|
+
return function (mod) {
|
|
28
|
+
if (mod && mod.__esModule) return mod;
|
|
29
|
+
var result = {};
|
|
30
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
31
|
+
__setModuleDefault(result, mod);
|
|
32
|
+
return result;
|
|
33
|
+
};
|
|
34
|
+
})();
|
|
35
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
+
exports.DEFAULT_AGENT_GUARD_SUPERVISOR_HEARTBEAT_MS = exports.DEFAULT_AGENT_GUARD_SUPERVISOR_DEBOUNCE_MS = exports.AGENT_GUARD_SUPERVISOR_SCHEMA_VERSION = void 0;
|
|
37
|
+
exports.inspectAgentGuardSupervisor = inspectAgentGuardSupervisor;
|
|
38
|
+
exports.startAgentGuardSupervisorDetached = startAgentGuardSupervisorDetached;
|
|
39
|
+
exports.stopAgentGuardSupervisor = stopAgentGuardSupervisor;
|
|
40
|
+
exports.runAgentGuardSupervisor = runAgentGuardSupervisor;
|
|
41
|
+
const node_child_process_1 = require("node:child_process");
|
|
42
|
+
const node_fs_1 = require("node:fs");
|
|
43
|
+
const node_path_1 = require("node:path");
|
|
44
|
+
const chokidar = __importStar(require("chokidar"));
|
|
45
|
+
exports.AGENT_GUARD_SUPERVISOR_SCHEMA_VERSION = 'neurcode.agent-guard-supervisor.v1';
|
|
46
|
+
exports.DEFAULT_AGENT_GUARD_SUPERVISOR_DEBOUNCE_MS = 500;
|
|
47
|
+
exports.DEFAULT_AGENT_GUARD_SUPERVISOR_HEARTBEAT_MS = 5_000;
|
|
48
|
+
const IGNORED_PATTERNS = [
|
|
49
|
+
'**/.git/**',
|
|
50
|
+
'**/.neurcode/**',
|
|
51
|
+
'**/node_modules/**',
|
|
52
|
+
'**/.next/**',
|
|
53
|
+
'**/dist/**',
|
|
54
|
+
'**/build/**',
|
|
55
|
+
'**/.DS_Store',
|
|
56
|
+
'**/Thumbs.db',
|
|
57
|
+
];
|
|
58
|
+
function normalizedMs(value, fallback, minimum = 50) {
|
|
59
|
+
return typeof value === 'number' && Number.isFinite(value)
|
|
60
|
+
? Math.max(minimum, Math.floor(value))
|
|
61
|
+
: fallback;
|
|
62
|
+
}
|
|
63
|
+
function now() {
|
|
64
|
+
return new Date().toISOString();
|
|
65
|
+
}
|
|
66
|
+
function statePath(repoRoot, sessionId) {
|
|
67
|
+
return (0, node_path_1.resolve)(repoRoot, '.neurcode', 'agent-guard-supervisor', `${sessionId}.json`);
|
|
68
|
+
}
|
|
69
|
+
function isSupervisorState(value) {
|
|
70
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
71
|
+
return false;
|
|
72
|
+
const record = value;
|
|
73
|
+
return record.schemaVersion === exports.AGENT_GUARD_SUPERVISOR_SCHEMA_VERSION
|
|
74
|
+
&& typeof record.sessionId === 'string'
|
|
75
|
+
&& typeof record.guardPath === 'string'
|
|
76
|
+
&& typeof record.repoRoot === 'string'
|
|
77
|
+
&& (typeof record.pid === 'number' || record.pid === null)
|
|
78
|
+
&& typeof record.status === 'string'
|
|
79
|
+
&& typeof record.startedAt === 'string'
|
|
80
|
+
&& typeof record.updatedAt === 'string'
|
|
81
|
+
&& typeof record.debounceMs === 'number'
|
|
82
|
+
&& typeof record.heartbeatMs === 'number'
|
|
83
|
+
&& typeof record.evaluationCount === 'number';
|
|
84
|
+
}
|
|
85
|
+
function processAlive(pid) {
|
|
86
|
+
if (!pid || pid <= 0)
|
|
87
|
+
return false;
|
|
88
|
+
try {
|
|
89
|
+
process.kill(pid, 0);
|
|
90
|
+
return true;
|
|
91
|
+
}
|
|
92
|
+
catch {
|
|
93
|
+
return false;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
function writeState(repoRoot, state) {
|
|
97
|
+
const path = statePath(repoRoot, state.sessionId);
|
|
98
|
+
(0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
|
|
99
|
+
const temporary = `${path}.${process.pid}.${Date.now()}.tmp`;
|
|
100
|
+
(0, node_fs_1.writeFileSync)(temporary, JSON.stringify(state, null, 2) + '\n', 'utf8');
|
|
101
|
+
(0, node_fs_1.renameSync)(temporary, path);
|
|
102
|
+
return path;
|
|
103
|
+
}
|
|
104
|
+
function newState(input) {
|
|
105
|
+
const generatedAt = input.startedAt || now();
|
|
106
|
+
return {
|
|
107
|
+
schemaVersion: exports.AGENT_GUARD_SUPERVISOR_SCHEMA_VERSION,
|
|
108
|
+
sessionId: input.sessionId,
|
|
109
|
+
guardPath: input.guardPath,
|
|
110
|
+
repoRoot: input.repoRoot,
|
|
111
|
+
pid: input.pid,
|
|
112
|
+
status: input.status,
|
|
113
|
+
startedAt: generatedAt,
|
|
114
|
+
updatedAt: generatedAt,
|
|
115
|
+
heartbeatAt: null,
|
|
116
|
+
stoppedAt: null,
|
|
117
|
+
debounceMs: normalizedMs(input.debounceMs, exports.DEFAULT_AGENT_GUARD_SUPERVISOR_DEBOUNCE_MS),
|
|
118
|
+
heartbeatMs: normalizedMs(input.heartbeatMs, exports.DEFAULT_AGENT_GUARD_SUPERVISOR_HEARTBEAT_MS, 250),
|
|
119
|
+
evaluationCount: 0,
|
|
120
|
+
lastEvaluatedAt: null,
|
|
121
|
+
lastPass: null,
|
|
122
|
+
lastChangedFiles: 0,
|
|
123
|
+
lastError: null,
|
|
124
|
+
privacy: {
|
|
125
|
+
metadataOnly: true,
|
|
126
|
+
sourceUploaded: false,
|
|
127
|
+
sourceIncluded: false,
|
|
128
|
+
watchesPathsOnly: true,
|
|
129
|
+
},
|
|
130
|
+
};
|
|
131
|
+
}
|
|
132
|
+
function inspectAgentGuardSupervisor(repoRoot, sessionId) {
|
|
133
|
+
const path = statePath(repoRoot, sessionId);
|
|
134
|
+
if (!(0, node_fs_1.existsSync)(path)) {
|
|
135
|
+
return { statePath: path, exists: false, alive: false, state: null, effectiveStatus: 'missing' };
|
|
136
|
+
}
|
|
137
|
+
try {
|
|
138
|
+
const parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
|
|
139
|
+
if (!isSupervisorState(parsed)) {
|
|
140
|
+
return {
|
|
141
|
+
statePath: path,
|
|
142
|
+
exists: true,
|
|
143
|
+
alive: false,
|
|
144
|
+
state: null,
|
|
145
|
+
effectiveStatus: 'failed',
|
|
146
|
+
error: 'Invalid agent guard supervisor state schema.',
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
const alive = processAlive(parsed.pid);
|
|
150
|
+
const heartbeatReference = Date.parse(parsed.heartbeatAt || parsed.updatedAt);
|
|
151
|
+
const heartbeatFresh = Number.isFinite(heartbeatReference)
|
|
152
|
+
&& Date.now() - heartbeatReference <= Math.max(parsed.heartbeatMs * 3, 10_000);
|
|
153
|
+
const effectiveStatus = ((parsed.status === 'running' || parsed.status === 'starting' || parsed.status === 'stopping')
|
|
154
|
+
&& (!alive || !heartbeatFresh))
|
|
155
|
+
? 'stale'
|
|
156
|
+
: parsed.status;
|
|
157
|
+
return { statePath: path, exists: true, alive, state: parsed, effectiveStatus };
|
|
158
|
+
}
|
|
159
|
+
catch (error) {
|
|
160
|
+
return {
|
|
161
|
+
statePath: path,
|
|
162
|
+
exists: true,
|
|
163
|
+
alive: false,
|
|
164
|
+
state: null,
|
|
165
|
+
effectiveStatus: 'failed',
|
|
166
|
+
error: error instanceof Error ? error.message : String(error),
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
function startAgentGuardSupervisorDetached(input) {
|
|
171
|
+
const existing = inspectAgentGuardSupervisor(input.repoRoot, input.sessionId);
|
|
172
|
+
if (existing.state && existing.alive && (existing.effectiveStatus === 'running' || existing.effectiveStatus === 'starting')) {
|
|
173
|
+
return {
|
|
174
|
+
started: false,
|
|
175
|
+
alreadyRunning: true,
|
|
176
|
+
pid: existing.state.pid,
|
|
177
|
+
statePath: existing.statePath,
|
|
178
|
+
state: existing.state,
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
const debounceMs = normalizedMs(input.debounceMs, exports.DEFAULT_AGENT_GUARD_SUPERVISOR_DEBOUNCE_MS);
|
|
182
|
+
const startingState = newState({
|
|
183
|
+
repoRoot: input.repoRoot,
|
|
184
|
+
sessionId: input.sessionId,
|
|
185
|
+
guardPath: input.guardPath,
|
|
186
|
+
pid: null,
|
|
187
|
+
status: 'starting',
|
|
188
|
+
debounceMs,
|
|
189
|
+
});
|
|
190
|
+
const path = writeState(input.repoRoot, startingState);
|
|
191
|
+
const child = (0, node_child_process_1.spawn)(process.execPath, [
|
|
192
|
+
(0, node_path_1.resolve)(input.cliEntry),
|
|
193
|
+
'agent',
|
|
194
|
+
'guard',
|
|
195
|
+
'supervise',
|
|
196
|
+
'run',
|
|
197
|
+
'--dir',
|
|
198
|
+
input.repoRoot,
|
|
199
|
+
'--session-id',
|
|
200
|
+
input.sessionId,
|
|
201
|
+
'--guard-path',
|
|
202
|
+
input.guardPath,
|
|
203
|
+
'--debounce-ms',
|
|
204
|
+
String(debounceMs),
|
|
205
|
+
], {
|
|
206
|
+
cwd: input.repoRoot,
|
|
207
|
+
detached: true,
|
|
208
|
+
stdio: 'ignore',
|
|
209
|
+
env: {
|
|
210
|
+
...process.env,
|
|
211
|
+
NEURCODE_AGENT_GUARD_SUPERVISOR_CHILD: '1',
|
|
212
|
+
},
|
|
213
|
+
});
|
|
214
|
+
child.unref();
|
|
215
|
+
const latest = inspectAgentGuardSupervisor(input.repoRoot, input.sessionId);
|
|
216
|
+
const state = latest.state?.status === 'running'
|
|
217
|
+
? latest.state
|
|
218
|
+
: {
|
|
219
|
+
...startingState,
|
|
220
|
+
pid: child.pid ?? null,
|
|
221
|
+
updatedAt: now(),
|
|
222
|
+
};
|
|
223
|
+
if (state.status !== 'running')
|
|
224
|
+
writeState(input.repoRoot, state);
|
|
225
|
+
return { started: true, alreadyRunning: false, pid: state.pid, statePath: path, state };
|
|
226
|
+
}
|
|
227
|
+
function stopAgentGuardSupervisor(repoRoot, sessionId) {
|
|
228
|
+
const inspection = inspectAgentGuardSupervisor(repoRoot, sessionId);
|
|
229
|
+
if (!inspection.state) {
|
|
230
|
+
return {
|
|
231
|
+
signaled: false,
|
|
232
|
+
statePath: inspection.statePath,
|
|
233
|
+
state: null,
|
|
234
|
+
effectiveStatus: inspection.effectiveStatus,
|
|
235
|
+
};
|
|
236
|
+
}
|
|
237
|
+
const updatedAt = now();
|
|
238
|
+
const canSignal = inspection.alive && inspection.effectiveStatus !== 'stale';
|
|
239
|
+
const state = {
|
|
240
|
+
...inspection.state,
|
|
241
|
+
status: canSignal ? 'stopping' : 'stopped',
|
|
242
|
+
updatedAt,
|
|
243
|
+
stoppedAt: canSignal ? inspection.state.stoppedAt : updatedAt,
|
|
244
|
+
};
|
|
245
|
+
writeState(repoRoot, state);
|
|
246
|
+
if (canSignal && inspection.state.pid) {
|
|
247
|
+
try {
|
|
248
|
+
process.kill(inspection.state.pid, 'SIGTERM');
|
|
249
|
+
return { signaled: true, statePath: inspection.statePath, state, effectiveStatus: 'stopping' };
|
|
250
|
+
}
|
|
251
|
+
catch {
|
|
252
|
+
const stopped = { ...state, status: 'stale', updatedAt: now(), stoppedAt: now() };
|
|
253
|
+
writeState(repoRoot, stopped);
|
|
254
|
+
return { signaled: false, statePath: inspection.statePath, state: stopped, effectiveStatus: 'stale' };
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
return { signaled: false, statePath: inspection.statePath, state, effectiveStatus: 'stopped' };
|
|
258
|
+
}
|
|
259
|
+
async function runAgentGuardSupervisor(options) {
|
|
260
|
+
const existing = inspectAgentGuardSupervisor(options.repoRoot, options.sessionId);
|
|
261
|
+
if (existing.state && existing.alive && existing.state.pid !== process.pid) {
|
|
262
|
+
throw new Error(`Agent guard supervisor is already running for session ${options.sessionId} (pid ${existing.state.pid}).`);
|
|
263
|
+
}
|
|
264
|
+
const debounceMs = normalizedMs(options.debounceMs, exports.DEFAULT_AGENT_GUARD_SUPERVISOR_DEBOUNCE_MS);
|
|
265
|
+
const heartbeatMs = normalizedMs(options.heartbeatMs, exports.DEFAULT_AGENT_GUARD_SUPERVISOR_HEARTBEAT_MS, 250);
|
|
266
|
+
let state = newState({
|
|
267
|
+
repoRoot: options.repoRoot,
|
|
268
|
+
sessionId: options.sessionId,
|
|
269
|
+
guardPath: options.guardPath,
|
|
270
|
+
pid: process.pid,
|
|
271
|
+
status: 'running',
|
|
272
|
+
debounceMs,
|
|
273
|
+
heartbeatMs,
|
|
274
|
+
});
|
|
275
|
+
let watcher = null;
|
|
276
|
+
let debounceHandle = null;
|
|
277
|
+
let heartbeatHandle = null;
|
|
278
|
+
let exitHandle = null;
|
|
279
|
+
let evaluationRunning = false;
|
|
280
|
+
let evaluationQueued = false;
|
|
281
|
+
let stopped = false;
|
|
282
|
+
const persist = (patch = {}) => {
|
|
283
|
+
state = {
|
|
284
|
+
...state,
|
|
285
|
+
...patch,
|
|
286
|
+
updatedAt: now(),
|
|
287
|
+
};
|
|
288
|
+
writeState(options.repoRoot, state);
|
|
289
|
+
options.onState?.(state);
|
|
290
|
+
};
|
|
291
|
+
const evaluate = async () => {
|
|
292
|
+
if (stopped)
|
|
293
|
+
return;
|
|
294
|
+
if (evaluationRunning) {
|
|
295
|
+
evaluationQueued = true;
|
|
296
|
+
return;
|
|
297
|
+
}
|
|
298
|
+
evaluationRunning = true;
|
|
299
|
+
try {
|
|
300
|
+
const result = await options.onEvaluate();
|
|
301
|
+
persist({
|
|
302
|
+
heartbeatAt: now(),
|
|
303
|
+
evaluationCount: state.evaluationCount + 1,
|
|
304
|
+
lastEvaluatedAt: result.evaluatedAt || now(),
|
|
305
|
+
lastPass: result.pass,
|
|
306
|
+
lastChangedFiles: result.changedFiles,
|
|
307
|
+
lastError: null,
|
|
308
|
+
});
|
|
309
|
+
}
|
|
310
|
+
catch (error) {
|
|
311
|
+
persist({
|
|
312
|
+
heartbeatAt: now(),
|
|
313
|
+
lastError: error instanceof Error ? error.message : String(error),
|
|
314
|
+
});
|
|
315
|
+
}
|
|
316
|
+
finally {
|
|
317
|
+
evaluationRunning = false;
|
|
318
|
+
if (evaluationQueued && !stopped) {
|
|
319
|
+
evaluationQueued = false;
|
|
320
|
+
await evaluate();
|
|
321
|
+
}
|
|
322
|
+
}
|
|
323
|
+
};
|
|
324
|
+
const scheduleEvaluation = () => {
|
|
325
|
+
if (debounceHandle)
|
|
326
|
+
clearTimeout(debounceHandle);
|
|
327
|
+
debounceHandle = setTimeout(() => {
|
|
328
|
+
debounceHandle = null;
|
|
329
|
+
void evaluate();
|
|
330
|
+
}, debounceMs);
|
|
331
|
+
};
|
|
332
|
+
return await new Promise((resolvePromise, rejectPromise) => {
|
|
333
|
+
const shutdown = async (status = 'stopped') => {
|
|
334
|
+
if (stopped)
|
|
335
|
+
return;
|
|
336
|
+
stopped = true;
|
|
337
|
+
if (debounceHandle)
|
|
338
|
+
clearTimeout(debounceHandle);
|
|
339
|
+
if (heartbeatHandle)
|
|
340
|
+
clearInterval(heartbeatHandle);
|
|
341
|
+
if (exitHandle)
|
|
342
|
+
clearTimeout(exitHandle);
|
|
343
|
+
if (watcher)
|
|
344
|
+
await watcher.close();
|
|
345
|
+
persist({
|
|
346
|
+
status,
|
|
347
|
+
heartbeatAt: now(),
|
|
348
|
+
stoppedAt: now(),
|
|
349
|
+
});
|
|
350
|
+
resolvePromise(state);
|
|
351
|
+
};
|
|
352
|
+
const fail = async (error) => {
|
|
353
|
+
persist({ status: 'failed', lastError: error instanceof Error ? error.message : String(error) });
|
|
354
|
+
await shutdown('failed');
|
|
355
|
+
};
|
|
356
|
+
try {
|
|
357
|
+
writeState(options.repoRoot, state);
|
|
358
|
+
options.onState?.(state);
|
|
359
|
+
watcher = chokidar.watch(options.repoRoot, {
|
|
360
|
+
ignored: IGNORED_PATTERNS,
|
|
361
|
+
persistent: true,
|
|
362
|
+
ignoreInitial: true,
|
|
363
|
+
awaitWriteFinish: {
|
|
364
|
+
stabilityThreshold: 200,
|
|
365
|
+
pollInterval: 100,
|
|
366
|
+
},
|
|
367
|
+
});
|
|
368
|
+
watcher.on('add', scheduleEvaluation);
|
|
369
|
+
watcher.on('change', scheduleEvaluation);
|
|
370
|
+
watcher.on('unlink', scheduleEvaluation);
|
|
371
|
+
watcher.on('error', (error) => void fail(error));
|
|
372
|
+
heartbeatHandle = setInterval(() => {
|
|
373
|
+
persist({ heartbeatAt: now() });
|
|
374
|
+
}, heartbeatMs);
|
|
375
|
+
if (options.exitAfterMs && options.exitAfterMs > 0) {
|
|
376
|
+
exitHandle = setTimeout(() => void shutdown('stopped'), options.exitAfterMs);
|
|
377
|
+
}
|
|
378
|
+
process.once('SIGINT', () => void shutdown('stopped'));
|
|
379
|
+
process.once('SIGTERM', () => void shutdown('stopped'));
|
|
380
|
+
if (options.evaluateImmediately !== false)
|
|
381
|
+
void evaluate();
|
|
382
|
+
}
|
|
383
|
+
catch (error) {
|
|
384
|
+
rejectPromise(error);
|
|
385
|
+
}
|
|
386
|
+
});
|
|
387
|
+
}
|
|
388
|
+
//# sourceMappingURL=agent-guard-supervisor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-guard-supervisor.js","sourceRoot":"","sources":["../../src/utils/agent-guard-supervisor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import type { GovernanceSession } from '@neurcode-ai/governance-runtime';
|
|
2
|
+
export declare const AGENT_GUARD_SCHEMA_VERSION: "neurcode.agent-guard.v1";
|
|
3
|
+
export type AgentGuardChangeType = 'created' | 'modified' | 'deleted';
|
|
4
|
+
export type AgentGuardClassification = 'verified_prewrite' | 'denied_but_changed' | 'prewrite_call_without_verdict' | 'observed_after_only' | 'unverified_write';
|
|
5
|
+
export interface AgentGuardFileSnapshot {
|
|
6
|
+
path: string;
|
|
7
|
+
digest: string;
|
|
8
|
+
size: number;
|
|
9
|
+
}
|
|
10
|
+
export interface AgentGuardArtifact {
|
|
11
|
+
schemaVersion: typeof AGENT_GUARD_SCHEMA_VERSION;
|
|
12
|
+
guardId: string;
|
|
13
|
+
sessionId: string;
|
|
14
|
+
agent: string;
|
|
15
|
+
adapter: string;
|
|
16
|
+
repoRoot: string;
|
|
17
|
+
startedAt: string;
|
|
18
|
+
updatedAt: string;
|
|
19
|
+
finishedAt: string | null;
|
|
20
|
+
active: boolean;
|
|
21
|
+
baseline: {
|
|
22
|
+
fileCount: number;
|
|
23
|
+
treeHash: string;
|
|
24
|
+
files: AgentGuardFileSnapshot[];
|
|
25
|
+
};
|
|
26
|
+
privacy: {
|
|
27
|
+
metadataOnly: true;
|
|
28
|
+
sourceUploaded: false;
|
|
29
|
+
sourceIncluded: false;
|
|
30
|
+
localContentDigestsOnly: true;
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
export interface AgentGuardReadResult {
|
|
34
|
+
path: string;
|
|
35
|
+
exists: boolean;
|
|
36
|
+
artifact: AgentGuardArtifact | null;
|
|
37
|
+
error?: string;
|
|
38
|
+
}
|
|
39
|
+
export interface AgentGuardFileEvidence {
|
|
40
|
+
preWriteCallCount: number;
|
|
41
|
+
allowedPreWriteCheckCount: number;
|
|
42
|
+
deniedPreWriteCheckCount: number;
|
|
43
|
+
postWriteObservationCount: number;
|
|
44
|
+
latestEventAt: string | null;
|
|
45
|
+
}
|
|
46
|
+
export interface AgentGuardChangedFile {
|
|
47
|
+
path: string;
|
|
48
|
+
changeType: AgentGuardChangeType;
|
|
49
|
+
classification: AgentGuardClassification;
|
|
50
|
+
evidence: AgentGuardFileEvidence;
|
|
51
|
+
}
|
|
52
|
+
export interface AgentGuardEvaluation {
|
|
53
|
+
schemaVersion: typeof AGENT_GUARD_SCHEMA_VERSION;
|
|
54
|
+
ok: true;
|
|
55
|
+
pass: boolean;
|
|
56
|
+
status: 'following_contract' | 'attention_required';
|
|
57
|
+
generatedAt: string;
|
|
58
|
+
guardId: string;
|
|
59
|
+
sessionId: string;
|
|
60
|
+
agent: string;
|
|
61
|
+
adapter: string;
|
|
62
|
+
repoRoot: string;
|
|
63
|
+
summary: {
|
|
64
|
+
changedFiles: number;
|
|
65
|
+
verifiedPrewrite: number;
|
|
66
|
+
unverifiedWrites: number;
|
|
67
|
+
deniedButChanged: number;
|
|
68
|
+
observedAfterOnly: number;
|
|
69
|
+
prewriteCallsWithoutVerdict: number;
|
|
70
|
+
};
|
|
71
|
+
changedFiles: AgentGuardChangedFile[];
|
|
72
|
+
nextAction: string;
|
|
73
|
+
privacy: AgentGuardArtifact['privacy'];
|
|
74
|
+
}
|
|
75
|
+
export declare function captureAgentGuardSnapshot(repoRoot: string): AgentGuardFileSnapshot[];
|
|
76
|
+
export declare function createAgentGuardArtifact(input: {
|
|
77
|
+
repoRoot: string;
|
|
78
|
+
sessionId: string;
|
|
79
|
+
agent: string;
|
|
80
|
+
adapter: string;
|
|
81
|
+
startedAt?: string;
|
|
82
|
+
}): AgentGuardArtifact;
|
|
83
|
+
export declare function defaultAgentGuardPath(repoRoot: string, sessionId: string): string;
|
|
84
|
+
export declare function writeAgentGuardArtifact(repoRoot: string, artifact: AgentGuardArtifact, artifactPath?: string): string;
|
|
85
|
+
export declare function readAgentGuardArtifact(input: {
|
|
86
|
+
repoRoot: string;
|
|
87
|
+
sessionId?: string;
|
|
88
|
+
artifactPath?: string;
|
|
89
|
+
}): AgentGuardReadResult;
|
|
90
|
+
export declare function evaluateAgentGuard(repoRoot: string, artifact: AgentGuardArtifact, session: GovernanceSession): AgentGuardEvaluation;
|
|
91
|
+
export declare function markAgentGuardFinished(artifact: AgentGuardArtifact, finishedAt?: string): AgentGuardArtifact;
|
|
92
|
+
//# sourceMappingURL=agent-guard.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-guard.d.ts","sourceRoot":"","sources":["../../src/utils/agent-guard.ts"],"names":[],"mappings":"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"}
|