@rubytech/create-maxy 1.0.892 → 1.0.894

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-maxy",
-  "version": "1.0.892",
+  "version": "1.0.894",
   "description": "Install Maxy — AI for Productive People",
   "bin": {
     "create-maxy": "./dist/index.js"

package/payload/platform/lib/oauth-llm/dist/index.d.ts

@@ -2,7 +2,7 @@
  * OAuth-bearer LLM calls for admin-side classifiers (Task 740).
  *
  * Every admin-side classifier (memory-classify, memory-rank, commitment,
- * adherence, inbound-gateway, query classifier, summarisation, email
+ * inbound-gateway, query classifier, summarisation, email
  * screening) uses Claude Code OAuth credentials — never the Anthropic
  * API key. The API-key path is reserved for the public agent.
  *
@@ -46,7 +46,7 @@ export interface CallOauthLlmParams {
     /**
      * Hard timeout in ms for the model call. Default 60_000.
      *
-     * 60s fits short admin classifiers (commitment, adherence, query,
+     * 60s fits short admin classifiers (commitment, query,
      * inbound-gateway, screening, summary — all <2K input, <500 output).
      * Long-output callers MUST override per-call: `memory-classify` runs at
      * 8K maxTokens against documents up to 20K chars and has been observed

package/payload/platform/lib/oauth-llm/dist/index.js

@@ -3,7 +3,7 @@
  * OAuth-bearer LLM calls for admin-side classifiers (Task 740).
  *
  * Every admin-side classifier (memory-classify, memory-rank, commitment,
- * adherence, inbound-gateway, query classifier, summarisation, email
+ * inbound-gateway, query classifier, summarisation, email
  * screening) uses Claude Code OAuth credentials — never the Anthropic
  * API key. The API-key path is reserved for the public agent.
  *

package/payload/platform/lib/oauth-llm/src/index.ts

@@ -2,7 +2,7 @@
  * OAuth-bearer LLM calls for admin-side classifiers (Task 740).
  *
  * Every admin-side classifier (memory-classify, memory-rank, commitment,
- * adherence, inbound-gateway, query classifier, summarisation, email
+ * inbound-gateway, query classifier, summarisation, email
  * screening) uses Claude Code OAuth credentials — never the Anthropic
  * API key. The API-key path is reserved for the public agent.
  *
@@ -86,7 +86,7 @@ export interface CallOauthLlmParams {
   /**
    * Hard timeout in ms for the model call. Default 60_000.
    *
-   * 60s fits short admin classifiers (commitment, adherence, query,
+   * 60s fits short admin classifiers (commitment, query,
    * inbound-gateway, screening, summary — all <2K input, <500 output).
    * Long-output callers MUST override per-call: `memory-classify` runs at
    * 8K maxTokens against documents up to 20K chars and has been observed

package/payload/platform/plugins/admin/PLUGIN.md

@@ -1,6 +1,6 @@
 ---
 name: admin
-description: "Platform administration plugin. Provides system-status, public-hostname (deterministic Cloudflare public-URL resolver — single call returning the operator's canonical hostname so agents never guess property names on :CloudflareHostname nodes), brand-settings, account-manage, account-update, admin-add, admin-remove, admin-list, admin-update-pin, agent-list, agent-config-read, logs-read, plugin-read, skill-load (one-call resolve+read for SKILL.md by skill name — the canonical primitive for loading a named skill; plugin-read remains the reader for references/* and PLUGIN.md), store-skill (deterministic write counterpart to plugin-read; persists operator-authored skills as plugin files under the active account), render-component, session-reset, session-resume, file-attach, wifi, adherence-read (attention-weighted adherence ledger), and action-approval tools (action-pending, action-approve, action-reject, action-edit) for managing the Maxy platform."
+description: "Platform administration plugin. Provides system-status, public-hostname (deterministic Cloudflare public-URL resolver — single call returning the operator's canonical hostname so agents never guess property names on :CloudflareHostname nodes), brand-settings, account-manage, account-update, admin-add, admin-remove, admin-list, admin-update-pin, agent-list, agent-config-read, logs-read, plugin-read, skill-load (one-call resolve+read for SKILL.md by skill name — the canonical primitive for loading a named skill; plugin-read remains the reader for references/* and PLUGIN.md), store-skill (deterministic write counterpart to plugin-read; persists operator-authored skills as plugin files under the active account), render-component, session-reset, session-resume, file-attach, wifi, and action-approval tools (action-pending, action-approve, action-reject, action-edit) for managing the Maxy platform."
 tools:
   - system-status
   - public-hostname
@@ -21,7 +21,6 @@ tools:
   - session-reset
   - session-resume
   - file-attach
-  - adherence-read
   - action-pending
   - action-approve
   - action-reject

package/payload/platform/plugins/admin/mcp/dist/__tests__/skill-load-required-inputs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill-load-required-inputs.test.d.ts.map

package/payload/platform/plugins/admin/mcp/dist/__tests__/skill-load-required-inputs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-load-required-inputs.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/skill-load-required-inputs.test.ts"],"names":[],"mappings":""}

package/payload/platform/plugins/admin/mcp/dist/__tests__/skill-load-required-inputs.test.js

@@ -0,0 +1,141 @@
+// Task 1021 — skill-load surfaces `requiredInputs` to the agent.
+//
+// Tests the frontmatter parser (`parseRequiredInputs`) and the
+// integration contract: when a SKILL.md declares `requiredInputs:`, the
+// body the skill-load handler returns to the agent must carry a
+// `<!-- skill-input-contract requiredInputs=... -->` marker that
+// `parseClaudeStream` can grep without re-parsing YAML. This pair is the
+// writer; the stream-parser is the reader.
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { loadSkill, parseRequiredInputs } from "../skill-resolution.js";
+let root;
+beforeEach(() => {
+    root = mkdtempSync(join(tmpdir(), "skill-load-required-inputs-"));
+});
+afterEach(() => {
+    rmSync(root, { recursive: true, force: false });
+});
+function seedSkill(plugin, skill, body) {
+    const dir = join(root, "plugins", plugin, "skills", skill);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "SKILL.md"), body);
+}
+describe("parseRequiredInputs", () => {
+    it("property-brochure-shaped frontmatter parses one slot with two alternatives", () => {
+        const body = [
+            "---",
+            "name: property-brochure",
+            "description: Create A4 brochures",
+            "requiredInputs:",
+            "  - propertyAssetsDir | listingURL",
+            "---",
+            "",
+            "# Property Brochure",
+        ].join("\n");
+        expect(parseRequiredInputs(body)).toEqual([["propertyAssetsDir", "listingURL"]]);
+    });
+    it("make-brochure-shaped frontmatter parses two slots, each with two alternatives", () => {
+        const body = [
+            "---",
+            "name: make-brochure",
+            "description: end-to-end brochure",
+            "allowed-tools:",
+            "  - Bash",
+            "  - Read",
+            "requiredInputs:",
+            "  - agentURL | brandPackDir",
+            "  - listingURL | propertyAssetsDir",
+            "---",
+            "",
+            "# make-brochure",
+        ].join("\n");
+        expect(parseRequiredInputs(body)).toEqual([
+            ["agentURL", "brandPackDir"],
+            ["listingURL", "propertyAssetsDir"],
+        ]);
+    });
+    it("returns undefined when frontmatter has no requiredInputs key", () => {
+        const body = [
+            "---",
+            "name: plainly",
+            "description: Strip AI tells",
+            "---",
+            "",
+            "# Plainly",
+        ].join("\n");
+        expect(parseRequiredInputs(body)).toBeUndefined();
+    });
+    it("returns undefined when body has no frontmatter at all", () => {
+        expect(parseRequiredInputs("# Just a title\n\nNo frontmatter here.\n")).toBeUndefined();
+    });
+    it("stops scanning at the next column-0 key (no cross-talk into siblings)", () => {
+        const body = [
+            "---",
+            "name: example",
+            "requiredInputs:",
+            "  - x | y",
+            "allowed-tools:",
+            "  - Bash",
+            "  - Read",
+            "---",
+            "",
+        ].join("\n");
+        expect(parseRequiredInputs(body)).toEqual([["x", "y"]]);
+    });
+});
+describe("loadSkill + parseRequiredInputs integration", () => {
+    it("loadSkill returns body verbatim; parseRequiredInputs extracts the declared slots", async () => {
+        seedSkill("brochures", "property-brochure", [
+            "---",
+            "name: property-brochure",
+            "description: Create A4 brochures",
+            "requiredInputs:",
+            "  - propertyAssetsDir | listingURL",
+            "---",
+            "",
+            "# Property Brochure",
+        ].join("\n"));
+        const outcome = await loadSkill(root, "property-brochure");
+        expect(outcome.status).toBe("unique");
+        if (outcome.status !== "unique")
+            return;
+        expect(parseRequiredInputs(outcome.body)).toEqual([
+            ["propertyAssetsDir", "listingURL"],
+        ]);
+    });
+    it("loadSkill on a skill without requiredInputs leaves parser at undefined", async () => {
+        seedSkill("admin", "plainly", "---\nname: plainly\ndescription: Strip AI tells\n---\n\n# Plainly\n");
+        const outcome = await loadSkill(root, "plainly");
+        expect(outcome.status).toBe("unique");
+        if (outcome.status !== "unique")
+            return;
+        expect(parseRequiredInputs(outcome.body)).toBeUndefined();
+    });
+});
+describe("skill-input-contract marker shape (writer/reader contract)", () => {
+    it("the marker the handler prepends survives JSON round-trip and matches the stream-parser regex", () => {
+        // Mirror the regex literal in
+        // platform/ui/app/lib/claude-agent/stream-parser.ts (Task 1021).
+        const RE = /<!-- skill-input-contract requiredInputs=(\[[^]+?\]) -->/;
+        const slots = [["propertyAssetsDir", "listingURL"]];
+        const marker = `<!-- skill-input-contract requiredInputs=${JSON.stringify(slots)} -->`;
+        const m = marker.match(RE);
+        expect(m).not.toBeNull();
+        expect(JSON.parse(m[1])).toEqual(slots);
+    });
+    it("the make-brochure two-slot case also round-trips through the regex", () => {
+        const RE = /<!-- skill-input-contract requiredInputs=(\[[^]+?\]) -->/;
+        const slots = [
+            ["agentURL", "brandPackDir"],
+            ["listingURL", "propertyAssetsDir"],
+        ];
+        const marker = `<!-- skill-input-contract requiredInputs=${JSON.stringify(slots)} -->`;
+        const m = marker.match(RE);
+        expect(m).not.toBeNull();
+        expect(JSON.parse(m[1])).toEqual(slots);
+    });
+});
+//# sourceMappingURL=skill-load-required-inputs.test.js.map

package/payload/platform/plugins/admin/mcp/dist/__tests__/skill-load-required-inputs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-load-required-inputs.test.js","sourceRoot":"","sources":["../../src/__tests__/skill-load-required-inputs.test.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/admin/mcp/dist/index.js

@@ -20,7 +20,7 @@ import { homedir, hostname as osHostname } from "node:os";
 import QRCode from "qrcode";
 import { getSession, closeDriver } from "./lib/neo4j.js";
 import { getOnboardingState, completeOnboardingStep } from "./lib/onboarding.js";
-import { findSkillOwners, computePluginReadHint, loadSkill } from "./skill-resolution.js";
+import { findSkillOwners, computePluginReadHint, loadSkill, parseRequiredInputs } from "./skill-resolution.js";
 import { resolvePublicHostname } from "./lib/public-hostname.js";
 const server = new McpServer({
     name: "admin",
@@ -1740,9 +1740,25 @@ eagerTool(server, "skill-load", "Load a plugin skill's SKILL.md body by skill na
             };
         }
         const content = substituteBrandPlaceholders(outcome.body, outcome.absolutePath);
+        // Task 1021 — prepend a skill-input-contract notice when the skill's
+        // frontmatter declares `requiredInputs:`. The notice tells the agent
+        // to route missing inputs through AskUserQuestion (per IDENTITY.md
+        // "Skill-input resolution"); the embedded `<!-- skill-input-contract
+        // requiredInputs=... -->` marker is the per-turn keying signal that
+        // parseClaudeStream uses to fire [skill-input-resolution] /
+        // [skill-input-missing] observability lines.
+        const requiredInputs = parseRequiredInputs(outcome.body);
+        let bodyOut = content;
+        if (requiredInputs) {
+            const slotLabels = requiredInputs.map(s => s.join(" | ")).join(", ");
+            const marker = JSON.stringify(requiredInputs);
+            const notice = `<!-- skill-input-contract requiredInputs=${marker} -->\nREQUIRED INPUTS: ${slotLabels}\nIf the operator has not supplied each of these inputs, your next tool call MUST be AskUserQuestion. Do not use memory-search, conversation-search, graph-read, or task-get to guess the missing input.\n<!-- /skill-input-contract -->\n\n`;
+            bodyOut = notice + content;
+        }
         const ms = Date.now() - start;
-        console.log(`[skill-load] skillName=${skillName} result=unique pluginName=${outcome.pluginName} file=${outcome.file} bodyBytes=${content.length} ms=${ms}`);
-        return { content: [{ type: "text", text: content }] };
+        const reqLog = requiredInputs ? ` requiredInputs=${JSON.stringify(requiredInputs)}` : "";
+        console.log(`[skill-load] skillName=${skillName} result=unique pluginName=${outcome.pluginName} file=${outcome.file} bodyBytes=${bodyOut.length}${reqLog} ms=${ms}`);
+        return { content: [{ type: "text", text: bodyOut }] };
     }
     catch (err) {
         const ms = Date.now() - start;
@@ -3467,62 +3483,6 @@ eagerTool(server, "action-edit", "Edit a pending action's input and then execute
         };
     }
 });
-// ---------------------------------------------------------------------------
-// Adherence ledger read (Task 594) — file-backed query of the per-agent
-// adherence-ledger.json. Reads from disk on every call, never from cache,
-// so the returned score matches the on-disk state byte-for-byte. File-only
-// access keeps the answer authoritative even if the Hono server is down.
-// ---------------------------------------------------------------------------
-eagerTool(server, "adherence-read", "Read the attention-weighted adherence ledger for an agent in this account. Returns the ledger JSON (rules with counts, rolling_7d, samples, streaks) and the score. Reads the file on every call — the value is authoritative and matches `{accountDir}/agents/<agent>/adherence-ledger.json` on disk. Use to answer 'what is my adherence score' or to surface the top offenders. Defaults to the admin agent when no name is supplied.", {
-    agent: z.string().optional().describe("Agent name to query. Defaults to 'admin'."),
-}, async ({ agent }) => {
-    const TAG = "[adherence-read]";
-    const agentName = agent ?? "admin";
-    const ledgerPath = resolve(getAccountDir(), "agents", agentName, "adherence-ledger.json");
-    try {
-        if (!existsSync(ledgerPath)) {
-            const emptyBody = JSON.stringify({
-                agent_id: agentName,
-                account_id: ACCOUNT_ID,
-                rules: [],
-                score: 100,
-                note: "No ledger file yet — the agent has not run long enough to record data.",
-            }, null, 2);
-            console.error(`${TAG} agent=${agentName} status=empty-no-file`);
-            return { content: [{ type: "text", text: emptyBody }] };
-        }
-        const raw = readFileSync(ledgerPath, "utf-8");
-        const data = JSON.parse(raw);
-        const rules = Array.isArray(data?.rules) ? data.rules : [];
-        const total = rules.length;
-        let violating = 0;
-        const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;
-        const cutoff = Date.now() - sevenDaysMs;
-        for (const r of rules) {
-            const violations = Array.isArray(r?.violations) ? r.violations : [];
-            const inWindow = violations.filter((ts) => {
-                if (typeof ts !== "string")
-                    return false;
-                const t = Date.parse(ts);
-                return Number.isFinite(t) && t >= cutoff;
-            }).length;
-            if (inWindow > 0)
-                violating += 1;
-        }
-        const score = total > 0 ? Math.round(100 * (1 - violating / total)) : 100;
-        const out = { ...data, score };
-        console.error(`${TAG} agent=${agentName} score=${score} n_rules=${total}`);
-        return { content: [{ type: "text", text: JSON.stringify(out, null, 2) }] };
-    }
-    catch (err) {
-        const errMsg = err instanceof Error ? err.message : String(err);
-        console.error(`${TAG} failed agent=${agentName} err=${errMsg}`);
-        return {
-            content: [{ type: "text", text: `Failed to read adherence ledger for agent=${agentName}: ${errMsg}` }],
-            isError: true,
-        };
-    }
-});
 // Cleanup on exit (SIGTERM for systemd service stops on Pi)
 const cleanup = async () => {
     await closeDriver();