@nfinitmonkeys/clan-engine 0.2.0 → 0.4.0

package/dist/types.d.ts

@@ -6,7 +6,7 @@
  *  file's marker so a future engine can tell "my old output" from "my current
  *  output" and run migrations. Bump LAYOUT_VERSION when the template SHAPE
  *  changes (a path moves, a format changes); bump ENGINE_VERSION freely. */
-export declare const ENGINE_VERSION = "0.1.0";
+export declare const ENGINE_VERSION = "0.3.0";
 export declare const LAYOUT_VERSION = 1;
 /** The marker key written into generated-file frontmatter / headers. */
 export declare const GENERATED_BY = "clan-engine";
@@ -22,6 +22,12 @@ export interface ClanIdentity {
     description: string;
     tier: Tier;
     mode: Mode;
+    /** district box HTTP port (from .district/district.config.yaml http.port). */
+    boxPort?: string;
+    /** EXISTING vault root (repo-relative) when one was detected at a non-default
+     *  location — overrides the tier default so applying never mints a duplicate
+     *  vault (e.g. the jungle repo's own .brain/ despite tier jungle). */
+    brainRoot?: string;
     /** connected-mode credentials (drive .mcp.json). */
     jungle?: {
         apiUrl: string;
@@ -40,6 +46,30 @@ export interface GeneratedFile {
     /** POSIX chmod to apply after write (e.g. 0o755 for scripts). */
     chmod?: number;
 }
+/** Input handed to a brain-build curation hook. The engine stays zero-LLM —
+ *  the hook is supplied by a caller that has one (e.g. @nfinitmonkeys/clan). */
+export interface BrainCurateInput {
+    /** The mechanical candidate pages (already sanitized + create-only filtered). */
+    pages: GeneratedFile[];
+    identity: ClanIdentity;
+    /** Provenance, one line per candidate: "<page path> ← <source file>". */
+    sourceNotes: string[];
+}
+/** Returns the curated page set (replaces/augments the candidates). The engine
+ *  re-gates EVERY curated body through scanSensitive + create-only regardless —
+ *  an LLM echoing a secret from context is held back like a mined one. */
+export type BrainCurator = (input: BrainCurateInput) => Promise<GeneratedFile[]>;
+/**
+ * The clan itself as an encrypted-brain recipient — its alphaId plus its X25519
+ * ENCRYPTION public key (SPKI DER base64, the same convention as
+ * step_up_devices.public_key_spki). Handed to brain-build so a page marked
+ * `private: true` can be encrypted to the owner BEFORE any write. The private
+ * half NEVER reaches the engine; only this public identity does. Shape matches
+ * @nfinitmonkeys/clan-crypto's Recipient. */
+export interface BrainOwner {
+    alphaId: string;
+    spkiB64: string;
+}
 export type ActionKind = 'create' | 'update' | 'backup-replace' | 'merge' | 'append' | 'remove' | 'skip';
 export interface PlanAction {
     kind: ActionKind;
@@ -89,6 +119,10 @@ export interface InspectResult {
     /** brain vault present + its layout version (from .brain-meta.json). */
     hasBrain: boolean;
     brainLayoutVersion?: number;
+    /** where an EXISTING vault lives (repo-relative), checked across every known
+     *  root (.district/brain > .brain > .brains/*) — reconcile scaffolds THERE,
+     *  never a tier-default duplicate. Unset when no vault exists yet. */
+    brainRoot?: string;
     /** the reconciled state classification. */
     state: NodeState;
     /** actionable notes for the wizard / caller. */

package/dist/types.js

@@ -6,7 +6,7 @@
  *  file's marker so a future engine can tell "my old output" from "my current
  *  output" and run migrations. Bump LAYOUT_VERSION when the template SHAPE
  *  changes (a path moves, a format changes); bump ENGINE_VERSION freely. */
-export const ENGINE_VERSION = '0.1.0';
+export const ENGINE_VERSION = '0.3.0';
 export const LAYOUT_VERSION = 1;
 /** The marker key written into generated-file frontmatter / headers. */
 export const GENERATED_BY = 'clan-engine';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nfinitmonkeys/clan-engine",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Deterministic setup engine for Nfinit Monkeys clans \u2014 the single template + reconciliation authority behind the published CLIs and the internal fleet tooling. Idempotent, dry-run-by-default, non-destructive.",
   "type": "module",
   "bin": {
@@ -37,5 +37,8 @@
   },
   "dependencies": {
     "yaml": "^2.9.0"
+  },
+  "optionalDependencies": {
+    "@nfinitmonkeys/clan-crypto": "^0.1.0"
   }
 }