@nexo-alpha/context 0.1.0 → 0.2.0

package/dist/context.d.ts

@@ -1,4 +1,5 @@
-import type { ApplicationState, DevelopmentState, NexoApi, NexoApplication, NexoConstraint, NexoDecision, NexoJob, NexoService } from "@nexo-alpha/core";
+import type { ApplicationState, NexoApi, NexoApplication, NexoJob, NexoService } from "@nexo-alpha/core";
+import { type ApplicationKnowledge, type DevelopmentState, type NexoConstraint, type NexoDecision } from "./knowledge.js";
 export interface ModuleContext {
     readonly name: string;
     readonly description?: string | undefined;
@@ -23,6 +24,15 @@ export interface ApplicationContext {
     readonly constraints: readonly NexoConstraint[];
     readonly developmentState: DevelopmentState;
 }
-export declare function buildContext(app: NexoApplication): ApplicationContext;
+/**
+ * Builds an ApplicationContext from the structural model plus optional
+ * human-authored knowledge.
+ *
+ * @param app      The Nexo application (structure + lifecycle).
+ * @param knowledge Optional knowledge object created with createKnowledge().
+ *                  When omitted, decisions/constraints/developmentState are
+ *                  empty/default in the resulting context.
+ */
+export declare function buildContext(app: NexoApplication, knowledge?: ApplicationKnowledge): ApplicationContext;
 export declare function contextToJson(context: ApplicationContext): string;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,cAAc,EACd,YAAY,EACZ,OAAO,EACP,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;KAClC,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;CAC7C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,CA0BrE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAEjE"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,OAAO,EACP,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;KAClC,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;CAC7C;AASD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,eAAe,EACpB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,kBAAkB,CA0BpB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAEjE"}

package/dist/context.js

@@ -1,4 +1,19 @@
-export function buildContext(app) {
+const EMPTY_DEVELOPMENT_STATE = {
+    completed: [],
+    inProgress: [],
+    blocked: [],
+    knownIssues: []
+};
+/**
+ * Builds an ApplicationContext from the structural model plus optional
+ * human-authored knowledge.
+ *
+ * @param app      The Nexo application (structure + lifecycle).
+ * @param knowledge Optional knowledge object created with createKnowledge().
+ *                  When omitted, decisions/constraints/developmentState are
+ *                  empty/default in the resulting context.
+ */
+export function buildContext(app, knowledge) {
     const modules = app.getModules().map((module) => ({
         name: module.name,
         ...(module.description !== undefined && { description: module.description }),
@@ -19,9 +34,9 @@ export function buildContext(app) {
             state: app.state
         },
         modules,
-        decisions: app.getDecisions(),
-        constraints: app.getConstraints(),
-        developmentState: app.getDevelopmentState()
+        decisions: knowledge?.getDecisions() ?? [],
+        constraints: knowledge?.getConstraints() ?? [],
+        developmentState: knowledge?.getDevelopmentState() ?? EMPTY_DEVELOPMENT_STATE
     };
 }
 export function contextToJson(context) {

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAqCA,MAAM,UAAU,YAAY,CAAC,GAAoB;IAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAiB,EAAE,CAAC,CAAC;QAC/D,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAChE,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;QACvC,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;QAC1C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;KACxB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;YACtE,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB;QACD,OAAO;QACP,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE;QAC7B,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE;QACjC,gBAAgB,EAAE,GAAG,CAAC,mBAAmB,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAwCA,MAAM,uBAAuB,GAAqB;IAChD,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAoB,EACpB,SAAgC;IAEhC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAiB,EAAE,CAAC,CAAC;QAC/D,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAChE,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;QACvC,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;QAC1C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;KACxB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;YACtE,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB;QACD,OAAO;QACP,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE;QAC1C,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE;QAC9C,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,IAAI,uBAAuB;KAC9E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { buildContext, contextToJson } from "./context.js";
 export type { ApplicationContext, ModuleContext } from "./context.js";
+export { createKnowledge, knowledgeToJson, knowledgeFromJson } from "./knowledge.js";
+export type { ApplicationKnowledge, SerializedKnowledge, DevelopmentState, NexoConstraint, NexoDecision, NexoHistoryEntry } from "./knowledge.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,YAAY,EACZ,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,EAClB,aAAa,EACd,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,EAClB,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { buildContext, contextToJson } from "./context.js";
+export { createKnowledge, knowledgeToJson, knowledgeFromJson } from "./knowledge.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,YAAY,EACZ,aAAa,EACd,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACd,MAAM,cAAc,CAAC;AAOtB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,gBAAgB,CAAC"}

package/dist/knowledge.d.ts

@@ -0,0 +1,63 @@
+export interface NexoDecision {
+    readonly title: string;
+    readonly reason?: string;
+    readonly alternatives?: string;
+    readonly status?: string;
+}
+export interface NexoConstraint {
+    readonly description: string;
+    readonly reason?: string;
+}
+export interface DevelopmentState {
+    readonly currentObjective?: string;
+    readonly completed: readonly string[];
+    readonly inProgress: readonly string[];
+    readonly blocked: readonly string[];
+    readonly knownIssues: readonly string[];
+    readonly nextStep?: string;
+}
+export interface NexoHistoryEntry {
+    readonly timestamp: string;
+    readonly operation: string;
+    readonly target?: string;
+    readonly actor?: string;
+    readonly result: "success" | "denied" | "failed";
+    readonly detail?: string;
+}
+/**
+ * Human-authored knowledge about an application.
+ *
+ * Distinct from the structural model in @nexo-alpha/core, which describes
+ * what the application IS (modules, APIs, services, lifecycle). Knowledge
+ * describes what we know ABOUT the application: architectural decisions,
+ * constraints, current development state, and an audit history of operations.
+ *
+ * Create with createKnowledge() and pass to buildContext() to include in the
+ * application manifest, or to createReadInterface()/createWriteInterface() in
+ * @nexo-alpha/tools so the AI interface can read and write it.
+ */
+export interface ApplicationKnowledge {
+    addDecision(decision: NexoDecision): this;
+    getDecisions(): readonly NexoDecision[];
+    addConstraint(constraint: NexoConstraint): this;
+    getConstraints(): readonly NexoConstraint[];
+    /**
+     * Shallow-merges a partial patch into the current development state.
+     * Array fields (completed, inProgress, blocked, knownIssues) are replaced
+     * wholesale — the caller owns the full list, not an append log.
+     */
+    setDevelopmentState(patch: Partial<DevelopmentState>): this;
+    getDevelopmentState(): DevelopmentState;
+    addHistoryEntry(entry: Omit<NexoHistoryEntry, "timestamp">): this;
+    getHistory(): readonly NexoHistoryEntry[];
+}
+export declare function createKnowledge(): ApplicationKnowledge;
+export interface SerializedKnowledge {
+    readonly decisions: readonly NexoDecision[];
+    readonly constraints: readonly NexoConstraint[];
+    readonly developmentState: DevelopmentState;
+    readonly history: readonly NexoHistoryEntry[];
+}
+export declare function knowledgeToJson(knowledge: ApplicationKnowledge): string;
+export declare function knowledgeFromJson(json: string): ApplicationKnowledge;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1C,YAAY,IAAI,SAAS,YAAY,EAAE,CAAC;IAExC,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAChD,cAAc,IAAI,SAAS,cAAc,EAAE,CAAC;IAE5C;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAC5D,mBAAmB,IAAI,gBAAgB,CAAC;IAExC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IAClE,UAAU,IAAI,SAAS,gBAAgB,EAAE,CAAC;CAC3C;AAED,wBAAgB,eAAe,IAAI,oBAAoB,CAkDtD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC/C;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,oBAAoB,GAAG,MAAM,CAQvE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAuBpE"}

package/dist/knowledge.js

@@ -0,0 +1,71 @@
+export function createKnowledge() {
+    const decisions = [];
+    const constraints = [];
+    const history = [];
+    let developmentState = {
+        completed: [],
+        inProgress: [],
+        blocked: [],
+        knownIssues: []
+    };
+    const knowledge = {
+        addDecision(decision) {
+            decisions.push(decision);
+            return knowledge;
+        },
+        getDecisions() {
+            return [...decisions];
+        },
+        addConstraint(constraint) {
+            constraints.push(constraint);
+            return knowledge;
+        },
+        getConstraints() {
+            return [...constraints];
+        },
+        setDevelopmentState(patch) {
+            developmentState = { ...developmentState, ...patch };
+            return knowledge;
+        },
+        getDevelopmentState() {
+            return developmentState;
+        },
+        addHistoryEntry(entry) {
+            history.push({ ...entry, timestamp: new Date().toISOString() });
+            return knowledge;
+        },
+        getHistory() {
+            return [...history];
+        }
+    };
+    return knowledge;
+}
+export function knowledgeToJson(knowledge) {
+    const data = {
+        decisions: knowledge.getDecisions(),
+        constraints: knowledge.getConstraints(),
+        developmentState: knowledge.getDevelopmentState(),
+        history: knowledge.getHistory()
+    };
+    return JSON.stringify(data, null, 2);
+}
+export function knowledgeFromJson(json) {
+    const parsed = JSON.parse(json);
+    const knowledge = createKnowledge();
+    for (const decision of parsed.decisions ?? []) {
+        knowledge.addDecision(decision);
+    }
+    for (const constraint of parsed.constraints ?? []) {
+        knowledge.addConstraint(constraint);
+    }
+    if (parsed.developmentState) {
+        knowledge.setDevelopmentState(parsed.developmentState);
+    }
+    for (const entry of parsed.history ?? []) {
+        const entryCopy = { ...entry };
+        delete entryCopy.timestamp;
+        knowledge.addHistoryEntry(entryCopy);
+    }
+    return knowledge;
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AA6DA,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,IAAI,gBAAgB,GAAqB;QACvC,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;KAChB,CAAC;IAEF,MAAM,SAAS,GAAyB;QACtC,WAAW,CAAC,QAAQ;YAClB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,YAAY;YACV,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;QACxB,CAAC;QAED,aAAa,CAAC,UAAU;YACtB,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,cAAc;YACZ,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;QAC1B,CAAC;QAED,mBAAmB,CAAC,KAAK;YACvB,gBAAgB,GAAG,EAAE,GAAG,gBAAgB,EAAE,GAAG,KAAK,EAAE,CAAC;YACrD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,mBAAmB;YACjB,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,eAAe,CAAC,KAAK;YACnB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAChE,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,UAAU;YACR,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;QACtB,CAAC;KACF,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC;AASD,MAAM,UAAU,eAAe,CAAC,SAA+B;IAC7D,MAAM,IAAI,GAAwB;QAChC,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE;QACnC,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE;QACvC,gBAAgB,EAAE,SAAS,CAAC,mBAAmB,EAAE;QACjD,OAAO,EAAE,SAAS,CAAC,UAAU,EAAE;KAChC,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiC,CAAC;IAChE,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;QAC9C,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QAClD,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,SAAS,CAAC,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAC/B,OAAQ,SAAoC,CAAC,SAAS,CAAC;QACvD,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

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