@nexo-alpha/tools 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @nexo-alpha/tools
 
-A structured, provider-neutral **read interface** an AI development tool (or a CLI, or a script) can call to understand a [`@nexo-alpha/core`](https://www.npmjs.com/package/@nexo-alpha/core) application — instead of grepping source code or hand-walking the application object.
+A structured, provider-neutral **read and write interface** an AI development tool (or a CLI, or a script) can call to understand — and safely change — a [`@nexo-alpha/core`](https://www.npmjs.com/package/@nexo-alpha/core) application, instead of grepping source code or hand-walking the application object.
 
 ## Install
 
@@ -34,19 +34,60 @@ tools.getApplication();      // { name, version, description, state }
 tools.getModule("payments"); // full module metadata, or undefined
 tools.getDependents("orders"); // -> ["payments"]
 tools.getStatus();           // { state, developmentState }
+tools.getHistory();          // audit trail of write operations
+
+import { createWriteInterface } from "@nexo-alpha/tools";
+
+const writes = createWriteInterface(app, {
+  scopes: new Set(["modify-source"])
+});
+
+writes.createApi("payments", { name: "refundPayment", method: "POST", path: "/payments/:id/refund" });
+// -> { success: true, data: { name: "refundPayment", ... } }
+
+writes.updateConfiguration({ debug: true });
+// -> { success: false, error: 'Permission required: "modify-configuration" is not granted...' }
+
+import { createVerificationInterface } from "@nexo-alpha/tools";
+
+const verify = createVerificationInterface(app);
+
+verify.validateArchitecture();
+// -> { valid: true, issues: [] } (or issues for cycles / self-deps / unresolved dependency names)
+verify.checkApplicationHealth();
+// -> { state, moduleCount, apiCount, serviceCount, architecture }
+
+import { createMetricsCollector } from "@nexo-alpha/tools";
+
+const metrics = createMetricsCollector(app);
+// ... traffic happens via @nexo-alpha/hapi / jobs run via @nexo-alpha/scheduler ...
+metrics.getMetrics();
+// -> { apis: { refundPayment: { calls, errors, averageDurationMs } }, jobs: {...} }
 ```
 
 ## What's here
 
 `createReadInterface(app)` returns a `NexoReadInterface` with:
 
-`getApplication`, `getModules`, `getModule`, `getApi`, `getService`, `getDependencies`, `getDependents`, `getConfiguration`, `getArchitecture`, `getDecisions`, `getConstraints`, `getCurrentWork`, `getStatus`.
+`getApplication`, `getModules`, `getModule`, `getApi`, `getService`, `getDependencies`, `getDependents`, `getConfiguration`, `getArchitecture`, `getDecisions`, `getConstraints`, `getCurrentWork`, `getStatus`, `getHistory`.
 
 Name lookups (`getModule`, `getApi`, `getService`) return `undefined` when nothing matches rather than throwing — a tool probing an unfamiliar application should degrade gracefully, not crash.
 
+`createWriteInterface(app, grants)` returns a `NexoWriteInterface` with:
+
+`createModule`, `createApi`, `modifyApi`, `createService`, `modifyService`, `createJob`, `modifyJob`, `updateConfiguration`, `addDependency`.
+
+Each call is a `{ success, data?, error? }` result — never a throw — and runs through **Permission Check → Validation → Operation → Audit** (PRD section 18/20). `grants` is a `PermissionGrants` (`{ scopes: Set<"modify-source" | "modify-configuration"> }`) the caller constructs explicitly; there is no ambient or default-allow permission. Every call, whether denied, failed validation, or successful, is recorded via `app.addHistoryEntry()` and readable back through `getHistory()`.
+
+`createVerificationInterface(app)` returns a `NexoVerificationInterface` with:
+
+`validateConfiguration`, `validateArchitecture`, `inspectDependencies`, `checkApplicationHealth` — the in-memory subset of PRD section 19's "Verification Capabilities." `validateArchitecture` detects dependency cycles and self-dependencies (errors) and dependency names that don't resolve to a registered module (a warning, not an error — it may be an external system like `"stripe"`). `validateConfiguration` flags config values that won't survive `JSON.stringify` cleanly (functions, circular references). These are read-only diagnostics and are not audited to history, unlike the write interface. `run_tests`/`run_typecheck`/`run_lint`/`run_build` from PRD section 19 are **not implemented** — they'd need to shell out to an external target application's own toolchain via an explicit project-root argument, and this repo has no lint tooling configured to call yet; left for a future pass once that's needed.
+
+`createMetricsCollector(app)` returns a `NexoMetricsCollector` with `getMetrics()`, `reset()`, and `stop()`. Unlike the other three interfaces (stateless — computed fresh from `app` on every call), this one is **stateful**: it subscribes to `app.events` at creation time and accumulates call/run counts, error/failure counts, and average durations per API/job as `@nexo-alpha/hapi` and `@nexo-alpha/scheduler` emit `api.called`/`api.error`/`job.ran`/`job.failed`. `checkApplicationHealth()` stays a separate, static-structure concern — this is the live-runtime counterpart, not a replacement for it. Call `stop()` when you're done with a collector (e.g. between tests) so it unsubscribes rather than leaking listeners on `app.events`.
+
 ## Design notes
 
-- **Read-only.** There are no `createModule()`/`modifyApi()`-style write operations yet — those need a permissions/validation/audit layer that doesn't exist in Nexo yet.
+- **Explicit, bounded, auditable.** Per PRD section 20, write operations never bypass a permission check, and every attempt — granted or not — is audited. Actually running tests/lint/build (PRD section 19, "Verification Capabilities") is out of scope here; it's a separate tooling concern layered on top of a successful write.
 - **camelCase**, consistent with the rest of Nexo's API, even though early product docs sketched these as snake_case (`get_application()`) — that was pseudocode-level, not a literal contract.
 
 ## Related packages
@@ -56,7 +97,7 @@ Name lookups (`getModule`, `getApi`, `getService`) return `undefined` when nothi
 
 ## Status
 
-**v0.1-alpha.** No MCP server or CLI wiring yet — this is the interface those will eventually sit on top of.
+**v0.1-alpha.** No MCP server or CLI wiring yet — this is the interface those will eventually sit on top of. `create_test()` and the verification ops (`run_tests`, `run_lint`, etc.) from the PRD are not implemented yet. No tracing/spans — `createMetricsCollector` is counts and durations only.
 
 ## License
 

package/dist/index.d.ts

@@ -1,3 +1,11 @@
 export { createReadInterface } from "./read-interface.js";
 export type { NexoReadInterface, ApplicationArchitecture, ApplicationStatus } from "./read-interface.js";
+export { createWriteInterface } from "./write-interface.js";
+export type { NexoWriteInterface, PermissionScope, PermissionGrants, WriteOperationResult } from "./write-interface.js";
+export { createVerificationInterface } from "./verification-interface.js";
+export type { NexoVerificationInterface, ValidationSeverity, ValidationIssue, ValidationResult, DependencyGraphEntry, ApplicationHealth } from "./verification-interface.js";
+export { createMetricsCollector } from "./metrics-interface.js";
+export type { NexoMetricsCollector, NexoMetricsSnapshot, ApiMetrics, JobMetrics } from "./metrics-interface.js";
+export { createRunInterface } from "./run-interface.js";
+export type { NexoRunInterface, RunResult } from "./run-interface.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,2BAA2B,EAC5B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,UAAU,EACX,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,2 +1,6 @@
 export { createReadInterface } from "./read-interface.js";
+export { createWriteInterface } from "./write-interface.js";
+export { createVerificationInterface } from "./verification-interface.js";
+export { createMetricsCollector } from "./metrics-interface.js";
+export { createRunInterface } from "./run-interface.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EACL,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,2BAA2B,EAC5B,MAAM,6BAA6B,CAAC;AAWrC,OAAO,EACL,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAShC,OAAO,EACL,kBAAkB,EACnB,MAAM,oBAAoB,CAAC"}

package/dist/metrics-interface.d.ts

@@ -0,0 +1,22 @@
+import { type NexoApplication } from "@nexo-alpha/core";
+export interface ApiMetrics {
+    readonly calls: number;
+    readonly errors: number;
+    readonly averageDurationMs: number;
+}
+export interface JobMetrics {
+    readonly runs: number;
+    readonly failures: number;
+    readonly averageDurationMs: number;
+}
+export interface NexoMetricsSnapshot {
+    readonly apis: Readonly<Record<string, ApiMetrics>>;
+    readonly jobs: Readonly<Record<string, JobMetrics>>;
+}
+export interface NexoMetricsCollector {
+    getMetrics(): NexoMetricsSnapshot;
+    reset(): void;
+    stop(): void;
+}
+export declare function createMetricsCollector(app: NexoApplication): NexoMetricsCollector;
+//# sourceMappingURL=metrics-interface.d.ts.map

package/dist/metrics-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-interface.d.ts","sourceRoot":"","sources":["../src/metrics-interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,IAAI,mBAAmB,CAAC;IAClC,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;CACd;AAsBD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,GAAG,oBAAoB,CA0EjF"}

package/dist/metrics-interface.js

@@ -0,0 +1,73 @@
+import { NexoEvent } from "@nexo-alpha/core";
+function toRate(counters) {
+    return {
+        calls: counters.calls,
+        errors: counters.errors,
+        averageDurationMs: counters.calls === 0 ? 0 : counters.totalDurationMs / counters.calls
+    };
+}
+export function createMetricsCollector(app) {
+    let apis = new Map();
+    let jobs = new Map();
+    function bucket(map, key) {
+        let counters = map.get(key);
+        if (!counters) {
+            counters = { calls: 0, errors: 0, totalDurationMs: 0 };
+            map.set(key, counters);
+        }
+        return counters;
+    }
+    const onApiCalled = (event) => {
+        const counters = bucket(apis, event.api);
+        counters.calls += 1;
+        counters.totalDurationMs += event.durationMs;
+        if (event.statusCode >= 400) {
+            counters.errors += 1;
+        }
+    };
+    const onApiError = (event) => {
+        bucket(apis, event.api).errors += 1;
+    };
+    const onJobRan = (event) => {
+        const counters = bucket(jobs, event.job);
+        counters.calls += 1;
+        counters.totalDurationMs += event.durationMs;
+    };
+    const onJobFailed = (event) => {
+        const counters = bucket(jobs, event.job);
+        counters.errors += 1;
+    };
+    app.events.on(NexoEvent.API_CALLED, onApiCalled);
+    app.events.on(NexoEvent.API_ERROR, onApiError);
+    app.events.on(NexoEvent.JOB_RAN, onJobRan);
+    app.events.on(NexoEvent.JOB_FAILED, onJobFailed);
+    return {
+        getMetrics() {
+            const apiEntries = {};
+            for (const [name, counters] of apis) {
+                apiEntries[name] = toRate(counters);
+            }
+            const jobEntries = {};
+            for (const [name, counters] of jobs) {
+                const rate = toRate(counters);
+                jobEntries[name] = {
+                    runs: rate.calls,
+                    failures: rate.errors,
+                    averageDurationMs: rate.averageDurationMs
+                };
+            }
+            return { apis: apiEntries, jobs: jobEntries };
+        },
+        reset() {
+            apis = new Map();
+            jobs = new Map();
+        },
+        stop() {
+            app.events.off(NexoEvent.API_CALLED, onApiCalled);
+            app.events.off(NexoEvent.API_ERROR, onApiError);
+            app.events.off(NexoEvent.JOB_RAN, onJobRan);
+            app.events.off(NexoEvent.JOB_FAILED, onJobFailed);
+        }
+    };
+}
+//# sourceMappingURL=metrics-interface.js.map

package/dist/metrics-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-interface.js","sourceRoot":"","sources":["../src/metrics-interface.ts"],"names":[],"mappings":"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"}

package/dist/read-interface.d.ts

@@ -1,5 +1,5 @@
-import type { ApplicationState, DevelopmentState, NexoApi, NexoApplication, NexoConstraint, NexoDecision, NexoService } from "@nexo-alpha/core";
-import { type ApplicationContext, type ModuleContext } from "@nexo-alpha/context";
+import type { ApplicationState, NexoApi, NexoApplication, NexoService } from "@nexo-alpha/core";
+import { type ApplicationContext, type ApplicationKnowledge, type DevelopmentState, type ModuleContext, type NexoConstraint, type NexoDecision, type NexoHistoryEntry } from "@nexo-alpha/context";
 export interface ApplicationArchitecture {
     readonly modules: readonly ModuleContext[];
     readonly apis: readonly NexoApi[];
@@ -23,6 +23,7 @@ export interface NexoReadInterface {
     getConstraints(): readonly NexoConstraint[];
     getCurrentWork(): DevelopmentState;
     getStatus(): ApplicationStatus;
+    getHistory(): readonly NexoHistoryEntry[];
 }
-export declare function createReadInterface(app: NexoApplication): NexoReadInterface;
+export declare function createReadInterface(app: NexoApplication, knowledge?: ApplicationKnowledge): NexoReadInterface;
 //# sourceMappingURL=read-interface.d.ts.map

package/dist/read-interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-interface.d.ts","sourceRoot":"","sources":["../src/read-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACpD,UAAU,IAAI,SAAS,aAAa,EAAE,CAAC;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAClD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACvD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACrD,gBAAgB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,eAAe,IAAI,uBAAuB,CAAC;IAC3C,YAAY,IAAI,SAAS,YAAY,EAAE,CAAC;IACxC,cAAc,IAAI,SAAS,cAAc,EAAE,CAAC;IAC5C,cAAc,IAAI,gBAAgB,CAAC;IACnC,SAAS,IAAI,iBAAiB,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,GACnB,iBAAiB,CA6DnB"}
+{"version":3,"file":"read-interface.d.ts","sourceRoot":"","sources":["../src/read-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;CAC7C;AASD,MAAM,WAAW,iBAAiB;IAChC,cAAc,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACpD,UAAU,IAAI,SAAS,aAAa,EAAE,CAAC;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAClD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACvD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACrD,gBAAgB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,eAAe,IAAI,uBAAuB,CAAC;IAC3C,YAAY,IAAI,SAAS,YAAY,EAAE,CAAC;IACxC,cAAc,IAAI,SAAS,cAAc,EAAE,CAAC;IAC5C,cAAc,IAAI,gBAAgB,CAAC;IACnC,SAAS,IAAI,iBAAiB,CAAC;IAC/B,UAAU,IAAI,SAAS,gBAAgB,EAAE,CAAC;CAC3C;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,EACpB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,iBAAiB,CAiEnB"}

package/dist/read-interface.js

@@ -1,14 +1,20 @@
 import { buildContext } from "@nexo-alpha/context";
-export function createReadInterface(app) {
+const EMPTY_DEVELOPMENT_STATE = {
+    completed: [],
+    inProgress: [],
+    blocked: [],
+    knownIssues: []
+};
+export function createReadInterface(app, knowledge) {
     return {
         getApplication() {
-            return buildContext(app).application;
+            return buildContext(app, knowledge).application;
         },
         getModules() {
-            return buildContext(app).modules;
+            return buildContext(app, knowledge).modules;
         },
         getModule(name) {
-            return buildContext(app).modules.find((module) => module.name === name);
+            return buildContext(app, knowledge).modules.find((module) => module.name === name);
         },
         getApi(name) {
             return app.getApis().find((api) => api.name === name);
@@ -27,25 +33,28 @@ export function createReadInterface(app) {
         },
         getArchitecture() {
             return {
-                modules: buildContext(app).modules,
+                modules: buildContext(app, knowledge).modules,
                 apis: app.getApis(),
                 services: app.getServices()
             };
         },
         getDecisions() {
-            return app.getDecisions();
+            return knowledge?.getDecisions() ?? [];
         },
         getConstraints() {
-            return app.getConstraints();
+            return knowledge?.getConstraints() ?? [];
         },
         getCurrentWork() {
-            return app.getDevelopmentState();
+            return knowledge?.getDevelopmentState() ?? EMPTY_DEVELOPMENT_STATE;
         },
         getStatus() {
             return {
                 state: app.state,
-                developmentState: app.getDevelopmentState()
+                developmentState: knowledge?.getDevelopmentState() ?? EMPTY_DEVELOPMENT_STATE
             };
+        },
+        getHistory() {
+            return knowledge?.getHistory() ?? [];
         }
     };
 }

package/dist/read-interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-interface.js","sourceRoot":"","sources":["../src/read-interface.ts"],"names":[],"mappings":"AASA,OAAO,EACL,YAAY,EAGb,MAAM,qBAAqB,CAAC;AA6B7B,MAAM,UAAU,mBAAmB,CACjC,GAAoB;IAEpB,OAAO;QACL,cAAc;YACZ,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QACvC,CAAC;QAED,UAAU;YACR,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QACnC,CAAC;QAED,SAAS,CAAC,IAAI;YACZ,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,CAAC,IAAI;YACT,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,UAAU,CAAC,IAAI;YACb,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACpE,CAAC;QAED,eAAe,CAAC,UAAU;YACxB,OAAO,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACzC,CAAC;QAED,aAAa,CAAC,UAAU;YACtB,OAAO,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,gBAAgB;YACd,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,eAAe;YACb,OAAO;gBACL,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO;gBAClC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE;gBACnB,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE;aAC5B,CAAC;QACJ,CAAC;QAED,YAAY;YACV,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,cAAc;YACZ,OAAO,GAAG,CAAC,cAAc,EAAE,CAAC;QAC9B,CAAC;QAED,cAAc;YACZ,OAAO,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACnC,CAAC;QAED,SAAS;YACP,OAAO;gBACL,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,gBAAgB,EAAE,GAAG,CAAC,mBAAmB,EAAE;aAC5C,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"read-interface.js","sourceRoot":"","sources":["../src/read-interface.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,YAAY,EAQb,MAAM,qBAAqB,CAAC;AAa7B,MAAM,uBAAuB,GAAqB;IAChD,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,EAAE;CAChB,CAAC;AAmBF,MAAM,UAAU,mBAAmB,CACjC,GAAoB,EACpB,SAAgC;IAEhC,OAAO;QACL,cAAc;YACZ,OAAO,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,WAAW,CAAC;QAClD,CAAC;QAED,UAAU;YACR,OAAO,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC;QAC9C,CAAC;QAED,SAAS,CAAC,IAAI;YACZ,OAAO,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACrF,CAAC;QAED,MAAM,CAAC,IAAI;YACT,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,UAAU,CAAC,IAAI;YACb,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACpE,CAAC;QAED,eAAe,CAAC,UAAU;YACxB,OAAO,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACzC,CAAC;QAED,aAAa,CAAC,UAAU;YACtB,OAAO,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,gBAAgB;YACd,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,eAAe;YACb,OAAO;gBACL,OAAO,EAAE,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,OAAO;gBAC7C,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE;gBACnB,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE;aAC5B,CAAC;QACJ,CAAC;QAED,YAAY;YACV,OAAO,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QAED,cAAc;YACZ,OAAO,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAC3C,CAAC;QAED,cAAc;YACZ,OAAO,SAAS,EAAE,mBAAmB,EAAE,IAAI,uBAAuB,CAAC;QACrE,CAAC;QAED,SAAS;YACP,OAAO;gBACL,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,IAAI,uBAAuB;aAC9E,CAAC;QACJ,CAAC;QAED,UAAU;YACR,OAAO,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/run-interface.d.ts

@@ -0,0 +1,34 @@
+export interface RunResult {
+    readonly success: boolean;
+    readonly command: string;
+    readonly exitCode: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly durationMs: number;
+}
+export interface NexoRunInterface {
+    runTests(): Promise<RunResult>;
+    runTypecheck(): Promise<RunResult>;
+    runBuild(): Promise<RunResult>;
+}
+/**
+ * Shells out to the target application's own toolchain to run its
+ * "test"/"typecheck"/"build" npm scripts, closing the process-shelling
+ * half of PRD section 19's verification ops (the other half —
+ * validateConfiguration/validateArchitecture/inspectDependencies/
+ * checkApplicationHealth — are pure in-memory checks in
+ * verification-interface.ts and don't need this).
+ *
+ * `run_lint()` is deliberately not implemented: there is no lint
+ * tooling convention to detect against (this repo itself has none
+ * configured), so building it now would mean guessing at a convention
+ * rather than following an established one.
+ *
+ * `projectRoot` is supplied by the caller rather than discovered here
+ * — @nexo-alpha/tools stays decoupled from the CLI's `nexo.config.json`
+ * convention (`packages/cli/src/config.ts`); a caller that already knows
+ * the project root (the CLI, or an AI tool given an explicit path) can
+ * pass it directly.
+ */
+export declare function createRunInterface(projectRoot: string): NexoRunInterface;
+//# sourceMappingURL=run-interface.d.ts.map

package/dist/run-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-interface.d.ts","sourceRoot":"","sources":["../src/run-interface.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;CAChC;AA4HD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAcxE"}

package/dist/run-interface.js

@@ -0,0 +1,121 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+function detectPackageManager(projectRoot) {
+    if (existsSync(join(projectRoot, "pnpm-lock.yaml"))) {
+        return "pnpm";
+    }
+    if (existsSync(join(projectRoot, "yarn.lock"))) {
+        return "yarn";
+    }
+    return "npm";
+}
+async function readScripts(projectRoot) {
+    const packageJsonPath = join(projectRoot, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        throw new Error(`No "package.json" found in project root "${projectRoot}".`);
+    }
+    const raw = await readFile(packageJsonPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const scripts = typeof parsed === "object" && parsed !== null
+        ? parsed.scripts
+        : undefined;
+    return typeof scripts === "object" && scripts !== null
+        ? scripts
+        : {};
+}
+function runCommand(projectRoot, command, args) {
+    const startedAt = Date.now();
+    const commandLabel = [command, ...args].join(" ");
+    return new Promise((resolvePromise) => {
+        const child = spawn(command, args, {
+            cwd: projectRoot,
+            shell: true
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", (error) => {
+            resolvePromise({
+                success: false,
+                command: commandLabel,
+                exitCode: null,
+                stdout,
+                stderr: stderr + (stderr ? "\n" : "") + error.message,
+                durationMs: Date.now() - startedAt
+            });
+        });
+        child.on("close", (exitCode) => {
+            resolvePromise({
+                success: exitCode === 0,
+                command: commandLabel,
+                exitCode,
+                stdout,
+                stderr,
+                durationMs: Date.now() - startedAt
+            });
+        });
+    });
+}
+function missingScriptResult(scriptName, projectRoot) {
+    return {
+        success: false,
+        command: `(no "${scriptName}" script)`,
+        exitCode: null,
+        stdout: "",
+        stderr: `"${projectRoot}"'s package.json has no "${scriptName}" script.`,
+        durationMs: 0
+    };
+}
+async function runScript(projectRoot, scriptName) {
+    const scripts = await readScripts(projectRoot);
+    if (typeof scripts[scriptName] !== "string") {
+        return missingScriptResult(scriptName, projectRoot);
+    }
+    const packageManager = detectPackageManager(projectRoot);
+    const args = packageManager === "npm"
+        ? ["run", scriptName]
+        : packageManager === "yarn"
+            ? [scriptName]
+            : ["run", scriptName];
+    return runCommand(projectRoot, packageManager, args);
+}
+/**
+ * Shells out to the target application's own toolchain to run its
+ * "test"/"typecheck"/"build" npm scripts, closing the process-shelling
+ * half of PRD section 19's verification ops (the other half —
+ * validateConfiguration/validateArchitecture/inspectDependencies/
+ * checkApplicationHealth — are pure in-memory checks in
+ * verification-interface.ts and don't need this).
+ *
+ * `run_lint()` is deliberately not implemented: there is no lint
+ * tooling convention to detect against (this repo itself has none
+ * configured), so building it now would mean guessing at a convention
+ * rather than following an established one.
+ *
+ * `projectRoot` is supplied by the caller rather than discovered here
+ * — @nexo-alpha/tools stays decoupled from the CLI's `nexo.config.json`
+ * convention (`packages/cli/src/config.ts`); a caller that already knows
+ * the project root (the CLI, or an AI tool given an explicit path) can
+ * pass it directly.
+ */
+export function createRunInterface(projectRoot) {
+    return {
+        runTests() {
+            return runScript(projectRoot, "test");
+        },
+        runTypecheck() {
+            return runScript(projectRoot, "typecheck");
+        },
+        runBuild() {
+            return runScript(projectRoot, "build");
+        }
+    };
+}
+//# sourceMappingURL=run-interface.js.map

package/dist/run-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-interface.js","sourceRoot":"","sources":["../src/run-interface.ts"],"names":[],"mappings":"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"}

package/dist/verification-interface.d.ts

@@ -0,0 +1,31 @@
+import type { ApplicationState, NexoApplication } from "@nexo-alpha/core";
+export type ValidationSeverity = "error" | "warning";
+export interface ValidationIssue {
+    readonly severity: ValidationSeverity;
+    readonly message: string;
+    readonly target?: string;
+}
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly issues: readonly ValidationIssue[];
+}
+export interface DependencyGraphEntry {
+    readonly module: string;
+    readonly dependencies: readonly string[];
+    readonly dependents: readonly string[];
+}
+export interface ApplicationHealth {
+    readonly state: ApplicationState;
+    readonly moduleCount: number;
+    readonly apiCount: number;
+    readonly serviceCount: number;
+    readonly architecture: ValidationResult;
+}
+export interface NexoVerificationInterface {
+    validateConfiguration(): ValidationResult;
+    validateArchitecture(): ValidationResult;
+    inspectDependencies(): readonly DependencyGraphEntry[];
+    checkApplicationHealth(): ApplicationHealth;
+}
+export declare function createVerificationInterface(app: NexoApplication): NexoVerificationInterface;
+//# sourceMappingURL=verification-interface.d.ts.map

package/dist/verification-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-interface.d.ts","sourceRoot":"","sources":["../src/verification-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,IAAI,gBAAgB,CAAC;IAC1C,oBAAoB,IAAI,gBAAgB,CAAC;IACzC,mBAAmB,IAAI,SAAS,oBAAoB,EAAE,CAAC;IACvD,sBAAsB,IAAI,iBAAiB,CAAC;CAC7C;AA4CD,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,eAAe,GACnB,yBAAyB,CAmH3B"}

package/dist/verification-interface.js

@@ -0,0 +1,125 @@
+function toValidationResult(issues) {
+    return {
+        valid: !issues.some((issue) => issue.severity === "error"),
+        issues
+    };
+}
+function detectCycle(moduleName, moduleNames, getDependencies, state, path) {
+    state.set(moduleName, "visiting");
+    path.push(moduleName);
+    for (const dependency of getDependencies(moduleName)) {
+        if (dependency === moduleName || !moduleNames.has(dependency)) {
+            continue;
+        }
+        const dependencyState = state.get(dependency);
+        if (dependencyState === "visiting") {
+            const cycleStart = path.indexOf(dependency);
+            return [...path.slice(cycleStart), dependency];
+        }
+        if (dependencyState !== "done") {
+            const cycle = detectCycle(dependency, moduleNames, getDependencies, state, path);
+            if (cycle) {
+                return cycle;
+            }
+        }
+    }
+    path.pop();
+    state.set(moduleName, "done");
+    return undefined;
+}
+export function createVerificationInterface(app) {
+    return {
+        validateConfiguration() {
+            const issues = [];
+            const config = app.getAllConfig();
+            for (const [key, value] of Object.entries(config)) {
+                if (typeof value === "function") {
+                    issues.push({
+                        severity: "warning",
+                        message: `Configuration key "${key}" holds a function, which will be silently dropped when serialized to JSON.`,
+                        target: key
+                    });
+                }
+            }
+            try {
+                JSON.stringify(config);
+            }
+            catch (error) {
+                issues.push({
+                    severity: "error",
+                    message: `Configuration is not JSON-serializable: ${error.message}`
+                });
+            }
+            return toValidationResult(issues);
+        },
+        validateArchitecture() {
+            const issues = [];
+            const moduleNames = new Set(app.getModules().map((module) => module.name));
+            for (const module of app.getModules()) {
+                const dependencies = app.getDependencies(module.name);
+                if (dependencies.includes(module.name)) {
+                    issues.push({
+                        severity: "error",
+                        message: `Module "${module.name}" depends on itself.`,
+                        target: module.name
+                    });
+                }
+                for (const dependency of dependencies) {
+                    if (dependency !== module.name && !moduleNames.has(dependency)) {
+                        issues.push({
+                            severity: "warning",
+                            message: `Module "${module.name}" depends on "${dependency}", which is not a registered module (may be an external system).`,
+                            target: module.name
+                        });
+                    }
+                }
+                for (const api of module.apis ?? []) {
+                    if (api.service) {
+                        const serviceExists = app.getServices().some((s) => s.name === api.service);
+                        if (!serviceExists) {
+                            issues.push({
+                                severity: "warning",
+                                message: `API "${api.name}" on module "${module.name}" references service "${api.service}", which is not registered.`,
+                                target: `${module.name}.${api.name}`
+                            });
+                        }
+                    }
+                }
+            }
+            const cycleState = new Map();
+            for (const moduleName of moduleNames) {
+                if (cycleState.get(moduleName) === "done") {
+                    continue;
+                }
+                const cycle = detectCycle(moduleName, moduleNames, (name) => app.getDependencies(name), cycleState, []);
+                if (cycle) {
+                    issues.push({
+                        severity: "error",
+                        message: `Dependency cycle detected: ${cycle.join(" -> ")}.`
+                    });
+                    for (const cycleMember of cycle) {
+                        cycleState.set(cycleMember, "done");
+                    }
+                }
+            }
+            return toValidationResult(issues);
+        },
+        inspectDependencies() {
+            return app.getModules().map((module) => ({
+                module: module.name,
+                dependencies: app.getDependencies(module.name),
+                dependents: app.getDependents(module.name)
+            }));
+        },
+        checkApplicationHealth() {
+            return {
+                state: app.state,
+                moduleCount: app.getModules().length,
+                apiCount: app.getApis().length,
+                serviceCount: app.getServices().length,
+                architecture: this.validateArchitecture()
+            };
+        }
+    };
+}
+//# sourceMappingURL=verification-interface.js.map

package/dist/verification-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-interface.js","sourceRoot":"","sources":["../src/verification-interface.ts"],"names":[],"mappings":"AAoCA,SAAS,kBAAkB,CAAC,MAAkC;IAC5D,OAAO;QACL,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC1D,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,UAAkB,EAClB,WAAgC,EAChC,eAAoD,EACpD,KAAuC,EACvC,IAAc;IAEd,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEtB,KAAK,MAAM,UAAU,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,IAAI,UAAU,KAAK,UAAU,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9D,SAAS;QACX,CAAC;QAED,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE9C,IAAI,eAAe,KAAK,UAAU,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,eAAe,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACjF,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,GAAoB;IAEpB,OAAO;QACL,qBAAqB;YACnB,MAAM,MAAM,GAAsB,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;YAElC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC;wBACV,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,sBAAsB,GAAG,6EAA6E;wBAC/G,MAAM,EAAE,GAAG;qBACZ,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,2CAA4C,KAAe,CAAC,OAAO,EAAE;iBAC/E,CAAC,CAAC;YACL,CAAC;YAED,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,oBAAoB;YAClB,MAAM,MAAM,GAAsB,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAE3E,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;gBACtC,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAEtD,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvC,MAAM,CAAC,IAAI,CAAC;wBACV,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,sBAAsB;wBACrD,MAAM,EAAE,MAAM,CAAC,IAAI;qBACpB,CAAC,CAAC;gBACL,CAAC;gBAED,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;oBACtC,IAAI,UAAU,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC/D,MAAM,CAAC,IAAI,CAAC;4BACV,QAAQ,EAAE,SAAS;4BACnB,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,iBAAiB,UAAU,kEAAkE;4BAC5H,MAAM,EAAE,MAAM,CAAC,IAAI;yBACpB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;oBACpC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;wBAChB,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;wBAC5E,IAAI,CAAC,aAAa,EAAE,CAAC;4BACnB,MAAM,CAAC,IAAI,CAAC;gCACV,QAAQ,EAAE,SAAS;gCACnB,OAAO,EAAE,QAAQ,GAAG,CAAC,IAAI,gBAAgB,MAAM,CAAC,IAAI,yBAAyB,GAAG,CAAC,OAAO,6BAA6B;gCACrH,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE;6BACrC,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAC;YAE1D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,CAAC;oBAC1C,SAAS;gBACX,CAAC;gBAED,MAAM,KAAK,GAAG,WAAW,CACvB,UAAU,EACV,WAAW,EACX,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,EACnC,UAAU,EACV,EAAE,CACH,CAAC;gBAEF,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,IAAI,CAAC;wBACV,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,8BAA8B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;qBAC7D,CAAC,CAAC;oBAEH,KAAK,MAAM,WAAW,IAAI,KAAK,EAAE,CAAC;wBAChC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;oBACtC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,mBAAmB;YACjB,OAAO,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBACvC,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,YAAY,EAAE,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC9C,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;aAC3C,CAAC,CAAC,CAAC;QACN,CAAC;QAED,sBAAsB;YACpB,OAAO;gBACL,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,MAAM;gBACpC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,MAAM;gBAC9B,YAAY,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,MAAM;gBACtC,YAAY,EAAE,IAAI,CAAC,oBAAoB,EAAE;aAC1C,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/write-interface.d.ts

@@ -0,0 +1,32 @@
+import { type NexoApi, type NexoApplication, type NexoJob, type NexoModule, type NexoService } from "@nexo-alpha/core";
+import { type ApplicationKnowledge, type DevelopmentState, type NexoConstraint, type NexoDecision } from "@nexo-alpha/context";
+export type PermissionScope = "modify-source" | "modify-configuration" | "modify-knowledge";
+export interface PermissionGrants {
+    readonly scopes: ReadonlySet<PermissionScope>;
+}
+export interface WriteOperationResult<T> {
+    readonly success: boolean;
+    readonly data?: T;
+    readonly error?: string;
+}
+export interface NexoWriteInterface {
+    createModule(module: NexoModule, actor?: string): WriteOperationResult<NexoModule>;
+    createApi(moduleName: string, api: NexoApi, actor?: string): WriteOperationResult<NexoApi>;
+    modifyApi(moduleName: string, apiName: string, patch: Partial<NexoApi>, actor?: string): WriteOperationResult<NexoApi>;
+    createService(moduleName: string, service: NexoService, actor?: string): WriteOperationResult<NexoService>;
+    modifyService(moduleName: string, serviceName: string, patch: Partial<NexoService>, actor?: string): WriteOperationResult<NexoService>;
+    createJob(moduleName: string, job: NexoJob, actor?: string): WriteOperationResult<NexoJob>;
+    modifyJob(moduleName: string, jobName: string, patch: Partial<NexoJob>, actor?: string): WriteOperationResult<NexoJob>;
+    updateConfiguration(patch: Record<string, unknown>, actor?: string): WriteOperationResult<Readonly<Record<string, unknown>>>;
+    addDependency(moduleName: string, dependencyName: string, actor?: string): WriteOperationResult<readonly string[]>;
+    recordDecision(decision: NexoDecision, actor?: string): WriteOperationResult<NexoDecision>;
+    recordConstraint(constraint: NexoConstraint, actor?: string): WriteOperationResult<NexoConstraint>;
+    updateDevelopmentState(patch: Partial<DevelopmentState>, actor?: string): WriteOperationResult<DevelopmentState>;
+    createTest(moduleName: string, testName: string, testSpec?: string, actor?: string): WriteOperationResult<{
+        module: string;
+        test: string;
+        spec?: string;
+    }>;
+}
+export declare function createWriteInterface(app: NexoApplication, knowledge: ApplicationKnowledge, grants: PermissionGrants): NexoWriteInterface;
+//# sourceMappingURL=write-interface.d.ts.map

package/dist/write-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-interface.d.ts","sourceRoot":"","sources":["../src/write-interface.ts"],"names":[],"mappings":"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"}

package/dist/write-interface.js

@@ -0,0 +1,218 @@
+import { NexoError } from "@nexo-alpha/core";
+function hasPermission(grants, scope) {
+    return grants.scopes.has(scope);
+}
+function historyEntry(operation, target, actor, result, detail) {
+    return {
+        operation,
+        result,
+        ...(target !== undefined ? { target } : {}),
+        ...(actor !== undefined ? { actor } : {}),
+        ...(detail !== undefined ? { detail } : {})
+    };
+}
+export function createWriteInterface(app, knowledge, grants) {
+    function denied(operation, target, scope, actor) {
+        const error = `Permission required: "${scope}" is not granted for operation "${operation}".`;
+        knowledge.addHistoryEntry(historyEntry(operation, target, actor, "denied", error));
+        return { success: false, error };
+    }
+    function failed(operation, target, actor, error) {
+        knowledge.addHistoryEntry(historyEntry(operation, target, actor, "failed", error));
+        return { success: false, error };
+    }
+    function succeeded(operation, target, actor, data) {
+        knowledge.addHistoryEntry(historyEntry(operation, target, actor, "success"));
+        return { success: true, data };
+    }
+    return {
+        createModule(module, actor) {
+            const operation = "create_module";
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, module.name, "modify-source", actor);
+            }
+            if (app.getModule(module.name)) {
+                return failed(operation, module.name, actor, `Nexo module "${module.name}" is already registered.`);
+            }
+            try {
+                app.module(module);
+                return succeeded(operation, module.name, actor, module);
+            }
+            catch (error) {
+                if (error instanceof NexoError) {
+                    return failed(operation, module.name, actor, error.message);
+                }
+                throw error;
+            }
+        },
+        createApi(moduleName, api, actor) {
+            const operation = "create_api";
+            const target = `${moduleName}.${api.name}`;
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, target, "modify-source", actor);
+            }
+            if (!app.getModule(moduleName)) {
+                return failed(operation, target, actor, `Nexo module "${moduleName}" is not registered.`);
+            }
+            try {
+                app.addApiToModule(moduleName, api);
+                return succeeded(operation, target, actor, api);
+            }
+            catch (error) {
+                if (error instanceof NexoError) {
+                    return failed(operation, target, actor, error.message);
+                }
+                throw error;
+            }
+        },
+        modifyApi(moduleName, apiName, patch, actor) {
+            const operation = "modify_api";
+            const target = `${moduleName}.${apiName}`;
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, target, "modify-source", actor);
+            }
+            try {
+                const updated = app.updateApi(moduleName, apiName, patch);
+                return succeeded(operation, target, actor, updated);
+            }
+            catch (error) {
+                if (error instanceof NexoError) {
+                    return failed(operation, target, actor, error.message);
+                }
+                throw error;
+            }
+        },
+        createService(moduleName, service, actor) {
+            const operation = "create_service";
+            const target = `${moduleName}.${service.name}`;
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, target, "modify-source", actor);
+            }
+            try {
+                app.addServiceToModule(moduleName, service);
+                return succeeded(operation, target, actor, service);
+            }
+            catch (error) {
+                if (error instanceof NexoError) {
+                    return failed(operation, target, actor, error.message);
+                }
+                throw error;
+            }
+        },
+        modifyService(moduleName, serviceName, patch, actor) {
+            const operation = "modify_service";
+            const target = `${moduleName}.${serviceName}`;
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, target, "modify-source", actor);
+            }
+            try {
+                const updated = app.updateService(moduleName, serviceName, patch);
+                return succeeded(operation, target, actor, updated);
+            }
+            catch (error) {
+                if (error instanceof NexoError) {
+                    return failed(operation, target, actor, error.message);
+                }
+                throw error;
+            }
+        },
+        createJob(moduleName, job, actor) {
+            const operation = "create_job";
+            const target = `${moduleName}.${job.name}`;
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, target, "modify-source", actor);
+            }
+            try {
+                app.addJobToModule(moduleName, job);
+                return succeeded(operation, target, actor, job);
+            }
+            catch (error) {
+                if (error instanceof NexoError) {
+                    return failed(operation, target, actor, error.message);
+                }
+                throw error;
+            }
+        },
+        modifyJob(moduleName, jobName, patch, actor) {
+            const operation = "modify_job";
+            const target = `${moduleName}.${jobName}`;
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, target, "modify-source", actor);
+            }
+            try {
+                const updated = app.updateJob(moduleName, jobName, patch);
+                return succeeded(operation, target, actor, updated);
+            }
+            catch (error) {
+                if (error instanceof NexoError) {
+                    return failed(operation, target, actor, error.message);
+                }
+                throw error;
+            }
+        },
+        updateConfiguration(patch, actor) {
+            const operation = "update_configuration";
+            if (!hasPermission(grants, "modify-configuration")) {
+                return denied(operation, undefined, "modify-configuration", actor);
+            }
+            const config = app.updateConfig(patch);
+            return succeeded(operation, undefined, actor, config);
+        },
+        addDependency(moduleName, dependencyName, actor) {
+            const operation = "add_dependency";
+            const target = `${moduleName} -> ${dependencyName}`;
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, target, "modify-source", actor);
+            }
+            try {
+                const dependencies = app.addModuleDependency(moduleName, dependencyName);
+                return succeeded(operation, target, actor, dependencies);
+            }
+            catch (error) {
+                if (error instanceof NexoError) {
+                    return failed(operation, target, actor, error.message);
+                }
+                throw error;
+            }
+        },
+        recordDecision(decision, actor) {
+            const operation = "record_decision";
+            const target = decision.title;
+            if (!hasPermission(grants, "modify-knowledge")) {
+                return denied(operation, target, "modify-knowledge", actor);
+            }
+            knowledge.addDecision(decision);
+            return succeeded(operation, target, actor, decision);
+        },
+        recordConstraint(constraint, actor) {
+            const operation = "record_constraint";
+            const target = constraint.description;
+            if (!hasPermission(grants, "modify-knowledge")) {
+                return denied(operation, target, "modify-knowledge", actor);
+            }
+            knowledge.addConstraint(constraint);
+            return succeeded(operation, target, actor, constraint);
+        },
+        updateDevelopmentState(patch, actor) {
+            const operation = "update_development_state";
+            if (!hasPermission(grants, "modify-knowledge")) {
+                return denied(operation, undefined, "modify-knowledge", actor);
+            }
+            knowledge.setDevelopmentState(patch);
+            return succeeded(operation, undefined, actor, knowledge.getDevelopmentState());
+        },
+        createTest(moduleName, testName, testSpec, actor) {
+            const operation = "create_test";
+            const target = `${moduleName}.${testName}`;
+            if (!hasPermission(grants, "modify-source")) {
+                return denied(operation, target, "modify-source", actor);
+            }
+            if (!app.getModule(moduleName)) {
+                return failed(operation, target, actor, `Nexo module "${moduleName}" is not registered.`);
+            }
+            const data = { module: moduleName, test: testName, ...(testSpec !== undefined ? { spec: testSpec } : {}) };
+            return succeeded(operation, target, actor, data);
+        }
+    };
+}
+//# sourceMappingURL=write-interface.js.map

package/dist/write-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-interface.js","sourceRoot":"","sources":["../src/write-interface.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexo-alpha/tools",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AI/tooling read interface for the Nexo framework",
   "keywords": [
     "nexo",
@@ -20,12 +20,15 @@
       "import": "./dist/index.js"
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@nexo-alpha/core": "0.1.1",
-    "@nexo-alpha/context": "0.1.0"
+    "@nexo-alpha/core": "0.2.0",
+    "@nexo-alpha/context": "0.2.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",