@karmaniverous/jeeves-meta 0.15.7 → 0.15.9

package/dist/interfaces/MetaContext.d.ts

@@ -33,4 +33,6 @@ export interface MetaContext {
     previousState: unknown;
     /** Archive snapshot file paths (for steer change detection, etc.). */
     archives: string[];
+    /** Nearest ancestor meta's _builder output, if available. */
+    ancestorBuilder?: string;
 }

package/dist/phaseState/derivePhaseState.d.ts

@@ -14,8 +14,6 @@ export interface DerivationInputs {
     structureChanged: boolean;
     /** Whether _steer changed vs. latest archive. */
     steerChanged: boolean;
-    /** Whether _architect prompt changed. */
-    architectChanged: boolean;
     /** Whether _crossRefs declaration changed. */
     crossRefsChanged: boolean;
     /** architectEvery config value. */

package/dist/phaseState/index.d.ts

@@ -4,6 +4,6 @@
  * @module phaseState
  */
 export { type DerivationInputs, derivePhaseState } from './derivePhaseState.js';
-export { type ArchitectInvalidator, computeInvalidation, type InvalidationResult, type StalenessInputs, } from './invalidate.js';
-export { buildPhaseCandidates, type PhaseCandidate, type PhaseCandidateInput, rankPhaseCandidates, selectPhaseCandidate, selectTier2Candidate, type Tier2Candidate, } from './phaseScheduler.js';
+export { type ArchitectInvalidator, computeInvalidation, type InputStatus, type InvalidationResult, } from './invalidate.js';
+export { buildPhaseCandidates, type PhaseCandidate, type PhaseCandidateInput, rankPhaseCandidates, selectAllTier2Candidates, selectPhaseCandidate, selectTier2Candidate, type Tier2Candidate, } from './phaseScheduler.js';
 export { architectSuccess, builderSuccess, criticSuccess, enforceInvariant, freshPhaseState, getOwedPhase, getPriorityBand, initialPhaseState, invalidateArchitect, invalidateBuilder, isFullyFresh, phaseFailed, phaseRunning, retryAllFailed, retryPhase, } from './phaseTransitions.js';

package/dist/phaseState/invalidate.d.ts

@@ -9,23 +9,21 @@
 import type { MetaNode } from '../discovery/types.js';
 import type { MetaConfig, MetaJson, PhaseState } from '../schema/index.js';
 /** Architect-level invalidation reasons. */
-export type ArchitectInvalidator = 'structureHash' | 'steer' | '_architect' | '_crossRefs' | 'architectEvery';
-/** Staleness inputs for a meta (exposed in /preview). */
-export interface StalenessInputs {
+export type ArchitectInvalidator = 'structureHash' | 'steer' | '_crossRefs' | 'firstRun' | 'architectEvery';
+/** Informational input status for a meta (exposed in /preview). */
+export interface InputStatus {
     structureHash: string;
     steerChanged: boolean;
     architectChanged: boolean;
+    criticChanged: boolean;
     crossRefsDeclChanged: boolean;
-    scopeMtimeMax: string | null;
     crossRefContentChanged: boolean;
 }
 /** Result of computing invalidation for a single meta. */
 export interface InvalidationResult {
     phaseState: PhaseState;
     architectInvalidators: ArchitectInvalidator[];
-    stalenessInputs: StalenessInputs;
-    structureHash: string;
-    steerChanged: boolean;
+    inputStatus: InputStatus;
 }
 /**
  * Compute invalidation inputs and apply cascade for a single meta.

package/dist/phaseState/phaseScheduler.d.ts

@@ -69,3 +69,8 @@ export interface Tier2Candidate {
  * @returns The stalest all-fresh candidate, or null if none exist.
  */
 export declare function selectTier2Candidate(metas: PhaseCandidateInput[]): Tier2Candidate | null;
+/**
+ * Select all fully-fresh, non-disabled, non-locked metas sorted by staleness
+ * (descending — stalest first) for Tier 2 invalidation scanning.
+ */
+export declare function selectAllTier2Candidates(metas: PhaseCandidateInput[]): Tier2Candidate[];

package/dist/phaseState/phaseTransitions.d.ts

@@ -24,7 +24,7 @@ export declare function initialPhaseState(): PhaseState;
 export declare function enforceInvariant(state: PhaseState): PhaseState;
 /**
  * Architect invalidated: architect → pending; builder, critic → stale.
- * Triggers: _structureHash change, _steer change, _architect change,
+ * Triggers: first run, _structureHash change, _steer change,
  * _crossRefs declaration change, _synthesisCount \>= architectEvery.
  */
 export declare function invalidateArchitect(state: PhaseState): PhaseState;

package/dist/routes/metasUpdate.d.ts

@@ -1,7 +1,7 @@
 /**
  * PATCH /metas/:path — update user-settable reserved properties on a meta.
  *
- * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled.
+ * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled, _architectTimeout, _builderTimeout, _criticTimeout.
  * Set a field to null to remove it. Unknown keys are rejected.
  *
  * @module routes/metasUpdate

package/dist/routes/status.d.ts

@@ -6,7 +6,7 @@
  *
  * @module routes/status
  */
-import type { ServiceState } from '@karmaniverous/jeeves-meta-core';
+import { type ServiceState } from '@karmaniverous/jeeves-meta-core';
 import type { FastifyInstance } from 'fastify';
 import type { RouteDeps } from './index.js';
 export type { ServiceState };

package/dist/rules/index.d.ts

@@ -21,10 +21,8 @@ export declare class RuleRegistrar {
     private readonly logger;
     private readonly watcherClient;
     private lastWatcherUptime;
-    private registered;
+    private registering;
     constructor(config: MetaConfig, logger: Logger, watcher: WatcherClient);
-    /** Whether rules have been successfully registered. */
-    get isRegistered(): boolean;
     /**
      * Register rules with watcher. Retries with exponential backoff.
      * Non-blocking — logs errors but never throws.

package/dist/scheduler/index.d.ts

@@ -63,4 +63,9 @@ export declare class Scheduler {
      * with weighted staleness as tiebreaker within a band.
      */
     private discoverNextPhase;
+    /**
+     * Tier 2 invalidation: iterate all-fresh candidates (stalest first),
+     * run computeInvalidation, and return the first that produces an owed phase.
+     */
+    private discoverTier2Phase;
 }

package/dist/schema/config.d.ts

@@ -13,6 +13,10 @@ declare const autoSeedRuleSchema: z.ZodObject<{
     match: z.ZodString;
     steer: z.ZodOptional<z.ZodString>;
     crossRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    parentDepth: z.ZodOptional<z.ZodNumber>;
+    architectTimeout: z.ZodOptional<z.ZodNumber>;
+    builderTimeout: z.ZodOptional<z.ZodNumber>;
+    criticTimeout: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /** Inferred type for an auto-seed rule. */
 export type AutoSeedRule = z.infer<typeof autoSeedRuleSchema>;
@@ -44,10 +48,15 @@ export declare const serviceConfigSchema: z.ZodObject<{
         level: z.ZodDefault<z.ZodString>;
         file: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    tier2ScanLimit: z.ZodDefault<z.ZodNumber>;
     autoSeed: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
         match: z.ZodString;
         steer: z.ZodOptional<z.ZodString>;
         crossRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        parentDepth: z.ZodOptional<z.ZodNumber>;
+        architectTimeout: z.ZodOptional<z.ZodNumber>;
+        builderTimeout: z.ZodOptional<z.ZodNumber>;
+        criticTimeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>>;
 }, z.core.$strip>;
 /** Inferred type for service configuration. */

package/dist/schema/meta.d.ts

@@ -43,6 +43,10 @@ export declare const metaJsonSchema: z.ZodObject<{
         message: z.ZodString;
     }, z.core.$strip>>;
     _disabled: z.ZodOptional<z.ZodBoolean>;
+    _architectTimeout: z.ZodOptional<z.ZodNumber>;
+    _builderTimeout: z.ZodOptional<z.ZodNumber>;
+    _criticTimeout: z.ZodOptional<z.ZodNumber>;
+    _ancestorBuilderHash: z.ZodOptional<z.ZodString>;
     _phaseState: z.ZodOptional<z.ZodObject<{
         architect: z.ZodEnum<{
             fresh: "fresh";

package/dist/seed/createMeta.d.ts

@@ -11,6 +11,12 @@ export interface CreateMetaOptions {
     crossRefs?: string[];
     /** Steering prompt for the meta. */
     steer?: string;
+    /** Per-entity timeout override for the architect phase (seconds). */
+    architectTimeout?: number;
+    /** Per-entity timeout override for the builder phase (seconds). */
+    builderTimeout?: number;
+    /** Per-entity timeout override for the critic phase (seconds). */
+    criticTimeout?: number;
 }
 /** Result of creating a new meta. */
 export interface CreateMetaResult {

package/package.json

@@ -1,48 +1,14 @@
 {
-  "name": "@karmaniverous/jeeves-meta",
-  "version": "0.15.7",
   "author": "Jason Williscroft",
-  "description": "Fastify HTTP service for the Jeeves Meta synthesis engine",
-  "license": "BSD-3-Clause",
-  "type": "module",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/karmaniverous/jeeves-meta.git",
-    "directory": "packages/service"
+  "bin": {
+    "jeeves-meta": "./dist/cli/jeeves-meta/index.js"
   },
   "bugs": {
     "url": "https://github.com/karmaniverous/jeeves-meta/issues"
   },
-  "homepage": "https://github.com/karmaniverous/jeeves-meta#readme",
-  "keywords": [
-    "synthesis",
-    "knowledge",
-    "meta",
-    "jeeves",
-    "service",
-    "fastify",
-    "typescript"
-  ],
-  "engines": {
-    "node": ">=22"
-  },
   "dependencies": {
-    "@karmaniverous/jeeves": "^0.5.10",
-    "@karmaniverous/jeeves-meta-core": "^0.1.1",
+    "@karmaniverous/jeeves": "^0.5.11",
+    "@karmaniverous/jeeves-meta-core": "^0.1.3",
     "commander": "^14",
     "croner": "^10",
     "fastify": "^5.8",
@@ -51,41 +17,56 @@
     "pino": "^10",
     "zod": "^4.4"
   },
+  "description": "Fastify HTTP service for the Jeeves Meta synthesis engine",
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.65.0",
+    "@dotenvx/dotenvx": "^1.69.1",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "^25.7.0",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
     "cross-env": "^10.1.0",
     "release-it": "^20.0.1",
-    "rollup": "^4.60.3",
+    "rollup": "^4.60.4",
     "rollup-plugin-copy": "^3.5.0",
     "tslib": "^2.8.1",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.7"
   },
-  "scripts": {
-    "build": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
-    "knip": "knip",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix .",
-    "test": "vitest run",
-    "typecheck": "tsc",
-    "changelog": "git-cliff -o CHANGELOG.md",
-    "release": "dotenvx run -f .env.local -- release-it",
-    "release:pre": "dotenvx run -f .env.local -- release-it --no-git.requireBranch --github.prerelease --preRelease"
+  "engines": {
+    "node": ">=22"
   },
-  "bin": {
-    "jeeves-meta": "./dist/cli/jeeves-meta/index.js"
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://github.com/karmaniverous/jeeves-meta#readme",
+  "keywords": [
+    "synthesis",
+    "knowledge",
+    "meta",
+    "jeeves",
+    "service",
+    "fastify",
+    "typescript"
+  ],
+  "license": "BSD-3-Clause",
+  "module": "dist/index.js",
+  "name": "@karmaniverous/jeeves-meta",
+  "publishConfig": {
+    "access": "public"
   },
   "release-it": {
     "git": {
       "changelog": "npx git-cliff --unreleased --strip header",
       "commitMessage": "chore: release @karmaniverous/jeeves-meta v${version}",
-      "tagName": "service/${version}",
-      "requireBranch": "main"
+      "requireBranch": "main",
+      "tagName": "service/${version}"
     },
     "github": {
       "release": true
@@ -110,5 +91,24 @@
     "npm": {
       "publish": true
     }
-  }
+  },
+  "repository": {
+    "directory": "packages/service",
+    "type": "git",
+    "url": "git+https://github.com/karmaniverous/jeeves-meta.git"
+  },
+  "scripts": {
+    "build": "rimraf dist && cross-env NO_COLOR=1 rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "changelog": "git-cliff -o CHANGELOG.md",
+    "knip": "knip",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "release": "dotenvx run -f .env.local -- release-it",
+    "release:pre": "dotenvx run -f .env.local -- release-it --no-git.requireBranch --github.prerelease --preRelease",
+    "test": "vitest run",
+    "typecheck": "tsc"
+  },
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "version": "0.15.9"
 }