@karmaniverous/jeeves-meta 0.13.10 → 0.14.0

package/README.md

@@ -65,6 +65,7 @@ jeeves-meta service install --config /path/to/jeeves-meta/config.json
 | POST | `/config/apply` | Apply a config patch (merge or replace) |
 | GET | `/queue` | Current queue state (current, pending, stats) |
 | POST | `/queue/clear` | Remove all pending queue items |
+| PATCH | `/metas/:path` | Update user-settable reserved properties (`_steer`, `_emphasis`, `_depth`, `_crossRefs`, `_disabled`) |
 
 ## Configuration
 

package/dist/cli/jeeves-meta/index.js

@@ -8554,6 +8554,7 @@ function computeSummary(entries, depthWeight) {
     let staleCount = 0;
     let errorCount = 0;
     let lockedCount = 0;
+    let disabledCount = 0;
     let neverSynthesizedCount = 0;
     let totalArchitectTokens = 0;
     let totalBuilderTokens = 0;
@@ -8569,6 +8570,8 @@ function computeSummary(entries, depthWeight) {
             errorCount++;
         if (e.locked)
             lockedCount++;
+        if (e.disabled)
+            disabledCount++;
         if (e.lastSynthesized === null)
             neverSynthesizedCount++;
         totalArchitectTokens += e.architectTokens ?? 0;
@@ -8593,6 +8596,7 @@ function computeSummary(entries, depthWeight) {
         stale: staleCount,
         errors: errorCount,
         locked: lockedCount,
+        disabled: disabledCount,
         neverSynthesized: neverSynthesizedCount,
         tokens: {
             architect: totalArchitectTokens,
@@ -9089,6 +9093,7 @@ async function listMetas(config, watcher) {
         const emphasis = meta._emphasis ?? 1;
         const hasError = Boolean(meta._error);
         const locked = isLocked(normalizePath(node.metaPath));
+        const disabled = meta._disabled === true;
         const neverSynth = !meta._generatedAt;
         // Compute staleness
         let stalenessSeconds;
@@ -9111,6 +9116,7 @@ async function listMetas(config, watcher) {
             lastSynthesized: meta._generatedAt ?? null,
             hasError,
             locked,
+            disabled,
             architectTokens: archTokens > 0 ? archTokens : null,
             builderTokens: buildTokens > 0 ? buildTokens : null,
             criticTokens: critTokens > 0 ? critTokens : null,
@@ -10056,6 +10062,8 @@ const metaJsonSchema = z
      * Cleared on successful cycle.
      */
     _error: metaErrorSchema.optional(),
+    /** When true, this meta is skipped during staleness scheduling. Manual trigger still works. */
+    _disabled: z.boolean().optional(),
 })
     .loose();
 
@@ -11762,7 +11770,7 @@ class Scheduler {
         try {
             const result = await listMetas(this.config, this.watcher);
             const stale = result.entries
-                .filter((e) => e.stalenessSeconds > 0)
+                .filter((e) => e.stalenessSeconds > 0 && !e.disabled)
                 .map((e) => ({
                 node: e.node,
                 meta: e.meta,
@@ -11921,6 +11929,10 @@ const metasQuerySchema = z.object({
         .enum(['true', 'false'])
         .transform((v) => v === 'true')
         .optional(),
+    disabled: z
+        .enum(['true', 'false'])
+        .transform((v) => v === 'true')
+        .optional(),
     fields: z.string().optional(),
 });
 const metaDetailQuerySchema = z.object({
@@ -11951,6 +11963,9 @@ function registerMetasRoutes(app, deps) {
         if (query.locked !== undefined) {
             entries = entries.filter((e) => e.locked === query.locked);
         }
+        if (query.disabled !== undefined) {
+            entries = entries.filter((e) => e.disabled === query.disabled);
+        }
         if (typeof query.staleHours === 'number') {
             entries = entries.filter((e) => e.stalenessSeconds >= query.staleHours * 3600);
         }
@@ -11966,6 +11981,7 @@ function registerMetasRoutes(app, deps) {
             'lastSynthesized',
             'hasError',
             'locked',
+            'disabled',
             'architectTokens',
             'builderTokens',
             'criticTokens',
@@ -11982,6 +11998,7 @@ function registerMetasRoutes(app, deps) {
                 lastSynthesized: e.lastSynthesized,
                 hasError: e.hasError,
                 locked: e.locked,
+                disabled: e.disabled,
                 architectTokens: e.architectTokens,
                 builderTokens: e.builderTokens,
                 criticTokens: e.criticTokens,
@@ -12087,6 +12104,91 @@ function registerMetasRoutes(app, deps) {
     });
 }
 
+/**
+ * PATCH /metas/:path — update user-settable reserved properties on a meta.
+ *
+ * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled.
+ * Set a field to null to remove it. Unknown keys are rejected.
+ *
+ * @module routes/metasUpdate
+ */
+const updateBodySchema = z
+    .object({
+    _steer: z.union([z.string(), z.null()]).optional(),
+    _emphasis: z.union([z.number().min(0), z.null()]).optional(),
+    _depth: z.union([z.number(), z.null()]).optional(),
+    _crossRefs: z.union([z.array(z.string()), z.null()]).optional(),
+    _disabled: z.union([z.boolean(), z.null()]).optional(),
+})
+    .strict();
+function registerMetasUpdateRoute(app, deps) {
+    app.patch('/metas/:path', async (request, reply) => {
+        const parseResult = updateBodySchema.safeParse(request.body);
+        if (!parseResult.success) {
+            return reply.status(400).send({
+                error: 'BAD_REQUEST',
+                message: parseResult.error.message,
+            });
+        }
+        const updates = parseResult.data;
+        const targetPath = normalizePath(decodeURIComponent(request.params.path));
+        const metaDir = resolveMetaDir(targetPath);
+        let meta;
+        try {
+            meta = (await readMetaJson(metaDir));
+        }
+        catch {
+            return reply.status(404).send({
+                error: 'NOT_FOUND',
+                message: 'Meta path not found: ' + targetPath,
+            });
+        }
+        const metaJsonPath = join(metaDir, 'meta.json');
+        const KEYS = [
+            '_steer',
+            '_emphasis',
+            '_depth',
+            '_crossRefs',
+            '_disabled',
+        ];
+        const toDelete = new Set();
+        const toSet = {};
+        for (const key of KEYS) {
+            const value = updates[key];
+            if (value === null) {
+                toDelete.add(key);
+            }
+            else if (value !== undefined) {
+                toSet[key] = value;
+            }
+        }
+        const updated = {};
+        for (const [k, v] of Object.entries(meta)) {
+            if (!toDelete.has(k))
+                updated[k] = v;
+        }
+        Object.assign(updated, toSet);
+        await writeFile(metaJsonPath, JSON.stringify(updated, null, 2) + '\n');
+        // Project the response — exclude the same large fields as the detail route.
+        const defaultExclude = new Set([
+            '_architect',
+            '_builder',
+            '_critic',
+            '_content',
+            '_feedback',
+        ]);
+        const projected = {};
+        for (const [k, v] of Object.entries(updated)) {
+            if (!defaultExclude.has(k))
+                projected[k] = v;
+        }
+        return reply.send({
+            path: metaDir,
+            meta: projected,
+        });
+    });
+}
+
 /**
  * GET /preview — dry-run synthesis preview.
  *
@@ -12408,7 +12510,7 @@ function registerSynthesizeRoute(app, deps) {
                 });
             }
             const stale = result.entries
-                .filter((e) => e.stalenessSeconds > 0)
+                .filter((e) => e.stalenessSeconds > 0 && !e.disabled)
                 .map((e) => ({
                 node: e.node,
                 meta: e.meta,
@@ -12487,6 +12589,7 @@ function registerRoutes(app, deps) {
     });
     registerStatusRoute(app, deps);
     registerMetasRoutes(app, deps);
+    registerMetasUpdateRoute(app);
     registerSynthesizeRoute(app, deps);
     registerPreviewRoute(app, deps);
     registerSeedRoute(app, deps);

package/dist/index.d.ts

@@ -316,6 +316,7 @@ declare const metaJsonSchema: z.ZodObject<{
         code: z.ZodString;
         message: z.ZodString;
     }, z.core.$strip>>;
+    _disabled: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 /** Inferred type for meta.json. */
 type MetaJson = z.infer<typeof metaJsonSchema>;
@@ -743,6 +744,8 @@ interface MetaEntry {
     hasError: boolean;
     /** Whether this meta is currently locked. */
     locked: boolean;
+    /** Whether this meta is disabled (skipped during staleness scheduling). */
+    disabled: boolean;
     /** Cumulative architect tokens, or null if never run. */
     architectTokens: number | null;
     /** Cumulative builder tokens, or null if never run. */
@@ -762,6 +765,7 @@ interface MetaListSummary {
     stale: number;
     errors: number;
     locked: number;
+    disabled: number;
     neverSynthesized: number;
     tokens: {
         architect: number;

package/dist/index.js

@@ -8292,6 +8292,7 @@ function computeSummary(entries, depthWeight) {
     let staleCount = 0;
     let errorCount = 0;
     let lockedCount = 0;
+    let disabledCount = 0;
     let neverSynthesizedCount = 0;
     let totalArchitectTokens = 0;
     let totalBuilderTokens = 0;
@@ -8307,6 +8308,8 @@ function computeSummary(entries, depthWeight) {
             errorCount++;
         if (e.locked)
             lockedCount++;
+        if (e.disabled)
+            disabledCount++;
         if (e.lastSynthesized === null)
             neverSynthesizedCount++;
         totalArchitectTokens += e.architectTokens ?? 0;
@@ -8331,6 +8334,7 @@ function computeSummary(entries, depthWeight) {
         stale: staleCount,
         errors: errorCount,
         locked: lockedCount,
+        disabled: disabledCount,
         neverSynthesized: neverSynthesizedCount,
         tokens: {
             architect: totalArchitectTokens,
@@ -8808,6 +8812,7 @@ async function listMetas(config, watcher) {
         const emphasis = meta._emphasis ?? 1;
         const hasError = Boolean(meta._error);
         const locked = isLocked(normalizePath(node.metaPath));
+        const disabled = meta._disabled === true;
         const neverSynth = !meta._generatedAt;
         // Compute staleness
         let stalenessSeconds;
@@ -8830,6 +8835,7 @@ async function listMetas(config, watcher) {
             lastSynthesized: meta._generatedAt ?? null,
             hasError,
             locked,
+            disabled,
             architectTokens: archTokens > 0 ? archTokens : null,
             builderTokens: buildTokens > 0 ? buildTokens : null,
             criticTokens: critTokens > 0 ? critTokens : null,
@@ -9587,6 +9593,8 @@ const metaJsonSchema = z
      * Cleared on successful cycle.
      */
     _error: metaErrorSchema.optional(),
+    /** When true, this meta is skipped during staleness scheduling. Manual trigger still works. */
+    _disabled: z.boolean().optional(),
 })
     .loose();
 
@@ -11293,7 +11301,7 @@ class Scheduler {
         try {
             const result = await listMetas(this.config, this.watcher);
             const stale = result.entries
-                .filter((e) => e.stalenessSeconds > 0)
+                .filter((e) => e.stalenessSeconds > 0 && !e.disabled)
                 .map((e) => ({
                 node: e.node,
                 meta: e.meta,
@@ -11452,6 +11460,10 @@ const metasQuerySchema = z.object({
         .enum(['true', 'false'])
         .transform((v) => v === 'true')
         .optional(),
+    disabled: z
+        .enum(['true', 'false'])
+        .transform((v) => v === 'true')
+        .optional(),
     fields: z.string().optional(),
 });
 const metaDetailQuerySchema = z.object({
@@ -11482,6 +11494,9 @@ function registerMetasRoutes(app, deps) {
         if (query.locked !== undefined) {
             entries = entries.filter((e) => e.locked === query.locked);
         }
+        if (query.disabled !== undefined) {
+            entries = entries.filter((e) => e.disabled === query.disabled);
+        }
         if (typeof query.staleHours === 'number') {
             entries = entries.filter((e) => e.stalenessSeconds >= query.staleHours * 3600);
         }
@@ -11497,6 +11512,7 @@ function registerMetasRoutes(app, deps) {
             'lastSynthesized',
             'hasError',
             'locked',
+            'disabled',
             'architectTokens',
             'builderTokens',
             'criticTokens',
@@ -11513,6 +11529,7 @@ function registerMetasRoutes(app, deps) {
                 lastSynthesized: e.lastSynthesized,
                 hasError: e.hasError,
                 locked: e.locked,
+                disabled: e.disabled,
                 architectTokens: e.architectTokens,
                 builderTokens: e.builderTokens,
                 criticTokens: e.criticTokens,
@@ -11618,6 +11635,91 @@ function registerMetasRoutes(app, deps) {
     });
 }
 
+/**
+ * PATCH /metas/:path — update user-settable reserved properties on a meta.
+ *
+ * Supported fields: _steer, _emphasis, _depth, _crossRefs, _disabled.
+ * Set a field to null to remove it. Unknown keys are rejected.
+ *
+ * @module routes/metasUpdate
+ */
+const updateBodySchema = z
+    .object({
+    _steer: z.union([z.string(), z.null()]).optional(),
+    _emphasis: z.union([z.number().min(0), z.null()]).optional(),
+    _depth: z.union([z.number(), z.null()]).optional(),
+    _crossRefs: z.union([z.array(z.string()), z.null()]).optional(),
+    _disabled: z.union([z.boolean(), z.null()]).optional(),
+})
+    .strict();
+function registerMetasUpdateRoute(app, deps) {
+    app.patch('/metas/:path', async (request, reply) => {
+        const parseResult = updateBodySchema.safeParse(request.body);
+        if (!parseResult.success) {
+            return reply.status(400).send({
+                error: 'BAD_REQUEST',
+                message: parseResult.error.message,
+            });
+        }
+        const updates = parseResult.data;
+        const targetPath = normalizePath(decodeURIComponent(request.params.path));
+        const metaDir = resolveMetaDir(targetPath);
+        let meta;
+        try {
+            meta = (await readMetaJson(metaDir));
+        }
+        catch {
+            return reply.status(404).send({
+                error: 'NOT_FOUND',
+                message: 'Meta path not found: ' + targetPath,
+            });
+        }
+        const metaJsonPath = join(metaDir, 'meta.json');
+        const KEYS = [
+            '_steer',
+            '_emphasis',
+            '_depth',
+            '_crossRefs',
+            '_disabled',
+        ];
+        const toDelete = new Set();
+        const toSet = {};
+        for (const key of KEYS) {
+            const value = updates[key];
+            if (value === null) {
+                toDelete.add(key);
+            }
+            else if (value !== undefined) {
+                toSet[key] = value;
+            }
+        }
+        const updated = {};
+        for (const [k, v] of Object.entries(meta)) {
+            if (!toDelete.has(k))
+                updated[k] = v;
+        }
+        Object.assign(updated, toSet);
+        await writeFile(metaJsonPath, JSON.stringify(updated, null, 2) + '\n');
+        // Project the response — exclude the same large fields as the detail route.
+        const defaultExclude = new Set([
+            '_architect',
+            '_builder',
+            '_critic',
+            '_content',
+            '_feedback',
+        ]);
+        const projected = {};
+        for (const [k, v] of Object.entries(updated)) {
+            if (!defaultExclude.has(k))
+                projected[k] = v;
+        }
+        return reply.send({
+            path: metaDir,
+            meta: projected,
+        });
+    });
+}
+
 /**
  * GET /preview — dry-run synthesis preview.
  *
@@ -11911,7 +12013,7 @@ function registerSynthesizeRoute(app, deps) {
                 });
             }
             const stale = result.entries
-                .filter((e) => e.stalenessSeconds > 0)
+                .filter((e) => e.stalenessSeconds > 0 && !e.disabled)
                 .map((e) => ({
                 node: e.node,
                 meta: e.meta,
@@ -11990,6 +12092,7 @@ function registerRoutes(app, deps) {
     });
     registerStatusRoute(app, deps);
     registerMetasRoutes(app, deps);
+    registerMetasUpdateRoute(app);
     registerSynthesizeRoute(app, deps);
     registerPreviewRoute(app, deps);
     registerSeedRoute(app, deps);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-meta",
-  "version": "0.13.10",
+  "version": "0.14.0",
   "author": "Jason Williscroft",
   "description": "Fastify HTTP service for the Jeeves Meta synthesis engine",
   "license": "BSD-3-Clause",
@@ -41,7 +41,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@karmaniverous/jeeves": "^0.5.5",
+    "@karmaniverous/jeeves": "^0.5.7",
     "commander": "^14",
     "croner": "^10",
     "fastify": "^5.8",