@moretea-labs/forge 1.5.1 → 1.7.0

package/assets/templates/helpers/maintenance-triage.sh

@@ -1,167 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-usage() {
-  cat <<'USAGE_EOF'
-Usage: scripts/maintenance-triage.sh [--json]
-USAGE_EOF
-}
-
-output_mode="text"
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --json)
-      output_mode="json"
-      shift
-      ;;
-    --help|-h)
-      usage
-      exit 0
-      ;;
-    *)
-      echo "Unknown argument: $1" >&2
-      usage
-      exit 1
-      ;;
-  esac
-done
-
-if [[ ! -f "tasks/lessons.md" ]]; then
-  if [[ "$output_mode" == "json" ]]; then
-    printf '{"guard":[],"eval":[],"skill_proposal":[]}\n'
-  else
-    echo "[Maintenance] No tasks/lessons.md found."
-  fi
-  exit 0
-fi
-
-if ! command -v jq >/dev/null 2>&1; then
-  echo "[Maintenance] jq is required for maintenance triage." >&2
-  exit 1
-fi
-
-lessons_json="$(
-  awk '
-    BEGIN {
-      count = 0
-      theme = ""
-      prevention = ""
-      trigger = ""
-      current_field = ""
-    }
-    function escape_json(value) {
-      gsub(/\\/, "\\\\", value)
-      gsub(/"/, "\\\"", value)
-      gsub(/\t/, "\\t", value)
-      gsub(/\r/, "\\r", value)
-      return value
-    }
-    function emit() {
-      if (theme == "" && prevention == "") {
-        return
-      }
-      count++
-      printf "%s{\"theme\":\"%s\",\"prevention\":\"%s\",\"trigger\":\"%s\"}", (count > 1 ? "," : ""), escape_json(theme), escape_json(prevention), escape_json(trigger)
-      theme = ""
-      prevention = ""
-      trigger = ""
-      current_field = ""
-    }
-    /^- Date:/ {
-      emit()
-      next
-    }
-    /^- Mistake pattern:/ {
-      theme = $0
-      sub(/^- Mistake pattern:[[:space:]]*/, "", theme)
-      current_field = "theme"
-      next
-    }
-    /^- Prevention rule:/ {
-      prevention = $0
-      sub(/^- Prevention rule:[[:space:]]*/, "", prevention)
-      current_field = "prevention"
-      next
-    }
-    /^- Triggered by correction:/ {
-      trigger = $0
-      sub(/^- Triggered by correction:[[:space:]]*/, "", trigger)
-      current_field = "trigger"
-      next
-    }
-    /^- [A-Za-z]/ {
-      current_field = ""
-      next
-    }
-    {
-      if (current_field == "theme" && $0 != "") {
-        theme = theme "\\n" $0
-      } else if (current_field == "prevention" && $0 != "") {
-        prevention = prevention "\\n" $0
-      } else if (current_field == "trigger" && $0 != "") {
-        trigger = trigger "\\n" $0
-      }
-    }
-    END {
-      emit()
-    }
-  ' tasks/lessons.md
-)"
-
-if [[ -z "$lessons_json" ]]; then
-  if [[ "$output_mode" == "json" ]]; then
-    printf '{"guard":[],"eval":[],"skill_proposal":[]}\n'
-  else
-    echo "[Maintenance] No repeated lessons to triage."
-  fi
-  exit 0
-fi
-
-triage_json="$(
-  jq -nc --argjson items "[${lessons_json}]" '
-    def keyify:
-      ascii_downcase | gsub("[^a-z0-9]+"; "-") | gsub("^-+|-+$"; "");
-    def candidate_type(theme; count):
-      if count >= 3 and (theme | test("guard|contract|plan|todo|sync|handoff|policy|workflow"; "i")) then "guard"
-      elif count >= 2 and (theme | test("test|verify|eval|review|qa|assert"; "i")) then "eval"
-      elif count >= 3 then "skill_proposal"
-      else empty
-      end;
-    reduce $items[] as $item (
-      {grouped:{}};
-      .grouped[$item.theme|keyify] += [$item]
-    )
-    | .grouped
-    | to_entries
-    | map({
-        key: .key,
-        theme: (.value[0].theme // .key),
-        count: (.value | length),
-        candidate: candidate_type((.value[0].theme // .key); (.value | length))
-      })
-    | reduce .[] as $entry (
-        {guard:[], eval:[], skill_proposal:[]};
-        if ($entry.candidate // "") != "" then
-          .[$entry.candidate] += [{
-            key: $entry.key,
-            theme: $entry.theme,
-            count: $entry.count
-          }]
-        else .
-        end
-      )
-  '
-)"
-
-if [[ "$output_mode" == "json" ]]; then
-  printf '%s\n' "$triage_json"
-  exit 0
-fi
-
-echo "[Maintenance] Guard candidates:"
-jq -r '.guard[]? | "- \(.theme) (\(.count))"' <<< "$triage_json"
-echo "[Maintenance] Eval candidates:"
-jq -r '.eval[]? | "- \(.theme) (\(.count))"' <<< "$triage_json"
-echo "[Maintenance] Skill proposal candidates:"
-jq -r '.skill_proposal[]? | "- \(.theme) (\(.count))"' <<< "$triage_json"

package/bin/forge-desktop-helper.mjs

@@ -1,204 +0,0 @@
-#!/usr/bin/env node
-import { execFile } from 'child_process';
-import { existsSync } from 'fs';
-import { createInterface } from 'readline';
-
-const SCHEMA_VERSION = 1;
-const PLUGIN_ID = 'desktop';
-const HELPER_VERSION = '1.0.0';
-const MAX_LINE_BYTES = 1_048_576;
-const MAX_COMMAND_OUTPUT_BYTES = 64 * 1024;
-const OSASCRIPT = '/usr/bin/osascript';
-const OPEN = '/usr/bin/open';
-const CAPABILITIES = ['status', 'observe', 'open_application'];
-
-function write(value) {
-  process.stdout.write(`${JSON.stringify(value)}\n`);
-}
-
-function bounded(value, max = 2_000) {
-  const source = String(value ?? '').replace(/(token|secret|password|authorization)\s*[=:]\s*\S+/gi, '$1=[REDACTED]');
-  return source.length > max ? source.slice(-max) : source;
-}
-
-function failure(requestId, code, message, retryable = false, details) {
-  write({
-    schemaVersion: SCHEMA_VERSION,
-    type: 'result',
-    requestId,
-    ok: false,
-    error: { code, message, retryable, ...(details ? { details } : {}) },
-  });
-}
-
-function success(requestId, result) {
-  write({ schemaVersion: SCHEMA_VERSION, type: 'result', requestId, ok: true, result });
-}
-
-function run(command, args, timeoutMs = 10_000) {
-  return new Promise((resolve) => {
-    execFile(command, args, {
-      encoding: 'utf8',
-      timeout: timeoutMs,
-      maxBuffer: MAX_COMMAND_OUTPUT_BYTES,
-      windowsHide: true,
-      env: {
-        PATH: '/usr/bin:/bin:/usr/sbin:/sbin',
-        HOME: process.env.HOME,
-        TMPDIR: process.env.TMPDIR,
-        LANG: process.env.LANG,
-        LC_ALL: process.env.LC_ALL,
-      },
-    }, (error, stdout, stderr) => {
-      resolve({
-        ok: !error,
-        code: typeof error?.code === 'number' ? error.code : null,
-        stdout: String(stdout ?? ''),
-        stderr: bounded(stderr || error?.message || ''),
-      });
-    });
-  });
-}
-
-function permissionDiagnostics() {
-  return {
-    accessibility: {
-      state: 'not_probed',
-      reason: 'The bundled helper does not trigger macOS consent prompts during status or observation.',
-    },
-    screenRecording: {
-      state: 'not_required',
-      reason: 'This version does not capture screenshots or screen pixels.',
-    },
-  };
-}
-
-async function status() {
-  return {
-    platform: process.platform,
-    helperVersion: HELPER_VERSION,
-    protocolVersion: SCHEMA_VERSION,
-    managed: true,
-    transport: 'stdio-jsonl',
-    capabilities: CAPABILITIES,
-    commands: {
-      openAvailable: existsSync(OPEN),
-      frontmostApplicationProbeAvailable: existsSync(OSASCRIPT),
-    },
-    permissions: permissionDiagnostics(),
-  };
-}
-
-async function observe() {
-  if (process.platform !== 'darwin') {
-    throw Object.assign(new Error('Desktop observation currently supports macOS only.'), { code: 'PLUGIN_DESKTOP_PLATFORM_UNSUPPORTED' });
-  }
-  if (!existsSync(OSASCRIPT)) {
-    return {
-      observed: false,
-      frontmostApplication: null,
-      permissions: permissionDiagnostics(),
-      warnings: ['The macOS NSWorkspace inspection bridge is unavailable.'],
-    };
-  }
-  const script = "ObjC.import('AppKit'); const app=$.NSWorkspace.sharedWorkspace.frontmostApplication; JSON.stringify({name:ObjC.unwrap(app.localizedName),bundleId:ObjC.unwrap(app.bundleIdentifier),pid:Number(app.processIdentifier)})";
-  const inspected = await run(OSASCRIPT, ['-l', 'JavaScript', '-e', script], 5_000);
-  if (!inspected.ok || !inspected.stdout.trim()) {
-    return {
-      observed: false,
-      frontmostApplication: null,
-      permissions: permissionDiagnostics(),
-      warnings: [bounded(inspected.stderr || 'Unable to resolve the frontmost application.')],
-    };
-  }
-  try {
-    const app = JSON.parse(inspected.stdout.trim());
-    return {
-      observed: true,
-      frontmostApplication: {
-        name: typeof app.name === 'string' ? app.name : null,
-        bundleId: typeof app.bundleId === 'string' ? app.bundleId : null,
-        pid: Number.isInteger(app.pid) && app.pid > 0 ? app.pid : null,
-      },
-      permissions: permissionDiagnostics(),
-      warnings: [],
-    };
-  } catch {
-    return {
-      observed: false,
-      frontmostApplication: null,
-      permissions: permissionDiagnostics(),
-      warnings: ['The macOS NSWorkspace bridge returned malformed application metadata.'],
-    };
-  }
-}
-
-async function openApplication(input) {
-  if (process.platform !== 'darwin') {
-    throw Object.assign(new Error('Application opening currently supports macOS only.'), { code: 'PLUGIN_DESKTOP_PLATFORM_UNSUPPORTED' });
-  }
-  const appName = typeof input.app_name === 'string' ? input.app_name.trim() : '';
-  const bundleId = typeof input.bundle_id === 'string' ? input.bundle_id.trim() : '';
-  if ((!appName && !bundleId) || (appName && bundleId)) {
-    throw Object.assign(new Error('Provide exactly one of app_name or bundle_id.'), { code: 'PLUGIN_ACTION_ARGUMENT_INVALID' });
-  }
-  const args = bundleId ? ['-b', bundleId] : ['-a', appName];
-  const opened = await run(OPEN, args, 20_000);
-  if (!opened.ok) {
-    throw Object.assign(new Error(opened.stderr || 'macOS open command failed.'), {
-      code: 'PLUGIN_DESKTOP_OPEN_FAILED',
-      retryable: true,
-    });
-  }
-  return { opened: true, selector: bundleId ? { bundleId } : { appName } };
-}
-
-async function execute(message) {
-  if (!message || typeof message !== 'object' || message.schemaVersion !== SCHEMA_VERSION || message.type !== 'execute') {
-    throw Object.assign(new Error('Invalid managed Desktop request envelope.'), { code: 'PLUGIN_MANAGED_PROCESS_PROTOCOL_ERROR' });
-  }
-  if (typeof message.requestId !== 'string' || typeof message.actionId !== 'string' || !message.input || typeof message.input !== 'object' || Array.isArray(message.input)) {
-    throw Object.assign(new Error('Invalid managed Desktop request fields.'), { code: 'PLUGIN_MANAGED_PROCESS_PROTOCOL_ERROR' });
-  }
-  if (message.actionId === 'status') return await status();
-  if (message.actionId === 'observe') return await observe();
-  if (message.actionId === 'open_application') return await openApplication(message.input);
-  throw Object.assign(new Error(`desktop/${message.actionId} is not supported.`), { code: 'PLUGIN_ACTION_NOT_SUPPORTED' });
-}
-
-write({
-  schemaVersion: SCHEMA_VERSION,
-  type: 'handshake',
-  protocolVersion: SCHEMA_VERSION,
-  pluginId: PLUGIN_ID,
-  helperVersion: HELPER_VERSION,
-  capabilities: CAPABILITIES,
-});
-
-const lines = createInterface({ input: process.stdin, crlfDelay: Infinity });
-let handled = false;
-lines.on('line', async (line) => {
-  if (handled) return;
-  handled = true;
-  if (Buffer.byteLength(line, 'utf8') > MAX_LINE_BYTES) {
-    failure('unknown', 'PLUGIN_MANAGED_PROCESS_REQUEST_TOO_LARGE', 'Managed Desktop request exceeded the bounded input limit.');
-    lines.close();
-    return;
-  }
-  let message;
-  try {
-    message = JSON.parse(line);
-    const result = await execute(message);
-    success(message.requestId, result);
-  } catch (error) {
-    const requestId = typeof message?.requestId === 'string' ? message.requestId : 'unknown';
-    failure(
-      requestId,
-      typeof error?.code === 'string' ? error.code : 'PLUGIN_DESKTOP_ACTION_FAILED',
-      bounded(error?.message || error),
-      error?.retryable === true,
-    );
-  } finally {
-    lines.close();
-  }
-});