@prismer/runtime 2.0.8 → 2.2.63

package/built-in-skills/prismer-apple-notes/NOTICE.md

@@ -0,0 +1,17 @@
+# Resource provenance
+
+## Engineering adaptation (2026-09-23)
+
+Source: https://github.com/NousResearch/hermes-agent/tree/1a1f4a59e252e1dc0137e7b2e7bcc8b0381d19c4/skills/apple/apple-notes
+
+Upstream authors: Hermes Agent.
+Hermes MIT copyright (c) 2025 Nous Research is preserved in LICENSE.
+All bundled references/templates/scripts remain covered by that notice unless
+an additional license is explicitly supplied. External CLI binaries, services,
+accounts and downloaded assets are not redistributed by this skill and retain
+their own terms. No API keys or third-party runtime packages are bundled.
+
+Prismer modifications: unique discovery/ownership mapping where applicable,
+resource-path and authorization corrections, bounded helpers, honest readiness
+and verification states. See docs/bugfix223/implementation-engineering.md in the
+source repository for resource mapping, tests and remaining live acceptance.

package/built-in-skills/prismer-apple-notes/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: prismer-apple-notes
+scope: common
+description: "Manage Apple Notes via memo CLI: create, search, edit."
+version: 1.0.1
+author: Hermes Agent
+license: MIT
+platforms: [ macos ]
+metadata:
+  nativeReplaces: [ apple-notes ]
+  hermes:
+    tags: [ Notes, Apple, macOS, note-taking ]
+    related_skills: [ obsidian ]
+  requiresExplicitGrant: true
+prerequisites:
+  commands: [ memo ]
+---
+
+## Prismer execution contract
+
+This is the uniquely named `prismer-apple-notes` skill, adapted from Hermes.
+Use the actual tools exposed by the executing host; examples using terminal,
+process, delegate_task, vision_analyze or browser_* are not tool registrations.
+Missing dependencies do not hide this skill. Report command startup, version,
+account/permissions and task-specific live verification separately. Use task-owned
+artifact paths and existing user authorization; do not change shared accounts,
+Runtime/provider configuration, global security settings or unrelated work.
+See NOTICE.md and LICENSE for resource provenance. Runtime availability and
+upstream-entry suppression are owned by the integration layer.
+
+
+# Apple Notes
+
+Use `memo` to manage Apple Notes directly from the terminal. Notes sync across all Apple devices via iCloud.
+
+## Prerequisites
+
+Run `python3 "$SKILL_ROOT/scripts/readiness.py" notes` using this installed
+skill's absolute directory. A PATH hit may be a broken Python launcher; a failed
+help/startup check is a dependency failure, not Notes authorization. Record the
+installed package version separately. Account sync and Automation require live
+acceptance on the executing Mac and are not tested by this helper.
+
+- **macOS** with Notes.app
+- Install: `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
+- Grant Automation access to Notes.app when prompted (System Settings → Privacy → Automation)
+
+## When to Use
+
+- User asks to create, view, or search Apple Notes
+- Saving information to Notes.app for cross-device access
+- Organizing notes into folders
+- Exporting notes to Markdown/HTML
+
+## When NOT to Use
+
+- Obsidian vault management → use the `obsidian` skill
+- Bear Notes → separate app (not supported here)
+- Quick agent-only notes → use the `memory` tool instead
+
+## Quick Reference
+
+### View Notes
+
+```bash
+memo notes                        # List all notes
+memo notes -f "Folder Name"       # Filter by folder
+memo notes -s "query"             # Search notes (fuzzy)
+```
+
+### Create Notes
+
+```bash
+memo notes -a                     # Add a note (opens your $EDITOR)
+memo notes -a -f "Folder Name"    # Add a note into a specific folder
+```
+
+`-a`/`--add` is a bare flag — it opens your `$EDITOR` to compose the note; it does
+not take a title argument. Use `-f/--folder` to target a folder. Set `$EDITOR`
+first (e.g. `export EDITOR=vim`).
+
+### Edit Notes
+
+```bash
+memo notes -e                     # Interactive selection to edit
+```
+
+### Delete Notes
+
+```bash
+memo notes -d                     # Interactive selection to delete
+```
+
+### Move Notes
+
+```bash
+memo notes -m                     # Move note to folder (interactive)
+```
+
+### Export Notes
+
+```bash
+memo notes -ex                    # Export to HTML/Markdown
+```
+
+## Limitations
+
+- Cannot edit notes containing images or attachments
+- Interactive prompts require terminal access (use pty=true if needed)
+- macOS only — requires Apple Notes.app
+
+## Rules
+
+1. Prefer Apple Notes when user wants cross-device sync (iPhone/iPad/Mac)
+2. Use the `memory` tool for agent-internal notes that don't need to sync
+3. Use the `obsidian` skill for Markdown-native knowledge management
+4. Select the exact authorized note/folder before editing, deleting or moving;
+   read back the result. Do not overwrite attachment-bearing notes.

package/built-in-skills/prismer-apple-notes/scripts/readiness.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""Read-only CLI startup probes. Never opens apps, TCC prompts or account data."""
+import argparse
+import json
+import platform
+import shutil
+import subprocess
+
+
+COMMANDS = {'notes': ['memo', 'notes', '--help'],
+            'reminders': ['remindctl', 'add', '--help'],
+            'imessage': ['imsg', 'send', '--help'],
+            'findmy': ['screencapture', '-h']}
+
+
+def probe(kind, run=subprocess.run):
+    result = {'kind': kind, 'os': platform.system(), 'binary': False,
+              'startup': False, 'account': 'untested', 'permissions': 'untested',
+              'live_operation': 'untested'}
+    if result['os'] != 'Darwin':
+        return {**result, 'reason': 'macOS execution host required'}
+    argv = COMMANDS[kind]
+    result['binary'] = bool(shutil.which(argv[0]))
+    if not result['binary']:
+        return {**result, 'reason': 'missing-command'}
+    try:
+        response = run(argv, capture_output=True, text=True, timeout=10, check=False)
+    except (OSError, subprocess.TimeoutExpired):
+        return {**result, 'reason': 'startup-failed'}
+    text = response.stdout + response.stderr
+    result['startup'] = response.returncode == 0 or (kind == 'findmy' and 'screencapture' in text and '-l' in text)
+    result['exit_code'] = response.returncode
+    if kind == 'reminders':
+        result['alarm_supported'] = '--alarm' in text
+    if kind == 'imessage':
+        result['send_flags_supported'] = all(flag in text for flag in ('--to', '--file', '--service'))
+    result['reason'] = 'help-only-not-ready-for-live-operation' if result['startup'] else 'startup-failed'
+    return result
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('kind', choices=COMMANDS)
+    args = parser.parse_args()
+    result = probe(args.kind)
+    print(json.dumps(result))
+    raise SystemExit(0 if result['startup'] else 1)

package/built-in-skills/prismer-apple-reminders/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nous Research
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/built-in-skills/prismer-apple-reminders/NOTICE.md

@@ -0,0 +1,17 @@
+# Resource provenance
+
+## Engineering adaptation (2026-09-23)
+
+Source: https://github.com/NousResearch/hermes-agent/tree/1a1f4a59e252e1dc0137e7b2e7bcc8b0381d19c4/skills/apple/apple-reminders
+
+Upstream authors: Hermes Agent.
+Hermes MIT copyright (c) 2025 Nous Research is preserved in LICENSE.
+All bundled references/templates/scripts remain covered by that notice unless
+an additional license is explicitly supplied. External CLI binaries, services,
+accounts and downloaded assets are not redistributed by this skill and retain
+their own terms. No API keys or third-party runtime packages are bundled.
+
+Prismer modifications: unique discovery/ownership mapping where applicable,
+resource-path and authorization corrections, bounded helpers, honest readiness
+and verification states. See docs/bugfix223/implementation-engineering.md in the
+source repository for resource mapping, tests and remaining live acceptance.

package/built-in-skills/prismer-apple-reminders/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: prismer-apple-reminders
+scope: common
+description: "Apple Reminders via remindctl: add, list, complete."
+version: 1.0.0
+author: Hermes Agent
+license: MIT
+platforms: [ macos ]
+metadata:
+  nativeReplaces: [ apple-reminders ]
+  hermes:
+    tags: [ Reminders, tasks, todo, macOS, Apple ]
+  requiresExplicitGrant: true
+prerequisites:
+  commands: [ remindctl ]
+---
+
+## Prismer execution contract
+
+This is the uniquely named `prismer-apple-reminders` skill, adapted from Hermes.
+Use the actual tools exposed by the executing host; examples using terminal,
+process, delegate_task, vision_analyze or browser_* are not tool registrations.
+Missing dependencies do not hide this skill. Report command startup, version,
+account/permissions and task-specific live verification separately. Use task-owned
+artifact paths and existing user authorization; do not change shared accounts,
+Runtime/provider configuration, global security settings or unrelated work.
+See NOTICE.md and LICENSE for resource provenance. Runtime availability and
+upstream-entry suppression are owned by the integration layer.
+
+
+# Apple Reminders
+
+Use `remindctl` to manage Apple Reminders directly from the terminal. Tasks sync across all Apple devices via iCloud.
+
+## Prerequisites
+
+Resolve SKILL_ROOT to this installed directory and run
+`python3 "$SKILL_ROOT/scripts/readiness.py" reminders`, then `remindctl --version`.
+The startup probe does not authorize EventKit or verify iCloud/notifications.
+The audited 0.1.1 lacks --alarm: enable the alarm examples below only when the
+installed add/edit help explicitly supports that flag. Otherwise report the
+early-notification requirement blocked; do not silently substitute a due date.
+
+- **macOS** with Reminders.app
+- Install: `brew install steipete/tap/remindctl`
+- Grant Reminders permission when prompted
+- Check: `remindctl status` / Request: `remindctl authorize`
+
+## When to Use
+
+- User mentions "reminder" or "Reminders app"
+- Creating personal to-dos with due dates that sync to iOS
+- Managing Apple Reminders lists
+- User wants tasks to appear on their iPhone/iPad
+
+## When NOT to Use
+
+- Scheduling agent alerts → use the actual Prismer task scheduler, not an invented cronjob tool
+- Calendar events → use Apple Calendar or Google Calendar
+- Project task management → use GitHub Issues, Notion, etc.
+- If user says "remind me" but means an agent alert → clarify first
+
+## Quick Reference
+
+### View Reminders
+
+```bash
+remindctl                    # Today's reminders
+remindctl today              # Today
+remindctl tomorrow           # Tomorrow
+remindctl week               # This week
+remindctl overdue            # Past due
+remindctl all                # Everything
+remindctl 2026-01-04         # Specific date
+```
+
+### Manage Lists
+
+```bash
+remindctl list               # List all lists
+remindctl list Work          # Show specific list
+remindctl list Projects --create    # Create list
+remindctl list Work --delete        # Delete list
+```
+
+### Create Reminders
+
+```bash
+remindctl add "Buy milk"
+remindctl add --title "Call mom" --list Personal --due tomorrow
+remindctl add --title "Meeting prep" --due "2026-02-15 09:00"
+```
+
+### Due Time vs Alarm / Early Nudge
+
+When the installed version supports both, `--due` and `--alarm` are different fields:
+
+- `--due` sets the reminder's due date/time.
+- `--alarm` sets the EventKit alarm/notification trigger. Timed due reminders may default to an alarm at the due time, but pass `--alarm` explicitly when the user asks for an earlier nudge.
+
+For a reminder due at 2:00 PM with a notification 30 minutes earlier:
+
+```bash
+remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"
+```
+
+To edit an existing reminder:
+
+```bash
+remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"
+```
+
+The Reminders UI may show or group the item by the alarm time because that is when the notification fires. Verify with JSON instead of assuming the due time moved:
+
+```bash
+remindctl today --json
+```
+
+Read the actual version's JSON schema; the following fields are version-dependent:
+
+- `dueDate`: actual due time
+- `alarmDate`: notification / early nudge time
+
+Apple's public `EKReminder` docs list only reminder-specific properties. Alarm support comes from inherited `EKCalendarItem` behavior exposed by remindctl's `--alarm` flag.
+
+### Complete / Delete
+
+```bash
+remindctl complete 1 2 3          # Complete by ID
+remindctl delete 4A83 --force     # Delete by ID
+```
+
+### Output Formats
+
+```bash
+remindctl today --json       # JSON for scripting
+remindctl today --plain      # TSV format
+remindctl today --quiet      # Counts only
+```
+
+## Date Formats
+
+Accepted by `--due` and date filters:
+- `today`, `tomorrow`, `yesterday`
+- `YYYY-MM-DD`
+- `YYYY-MM-DD HH:mm`
+- ISO 8601 (`2026-01-04T12:34:56Z`)
+
+## Rules
+
+1. Clarify Apple Reminders versus an agent scheduled task only when intent is ambiguous.
+2. Use the user's stated content/time authorization; clarify only missing fields.
+3. Use `--json` for programmatic parsing
+4. Record host timezone and resolved timestamp. Read back the exact created ID;
+   help/JSON success alone does not prove the notification was delivered.

package/built-in-skills/prismer-apple-reminders/scripts/readiness.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""Read-only CLI startup probes. Never opens apps, TCC prompts or account data."""
+import argparse
+import json
+import platform
+import shutil
+import subprocess
+
+
+COMMANDS = {'notes': ['memo', 'notes', '--help'],
+            'reminders': ['remindctl', 'add', '--help'],
+            'imessage': ['imsg', 'send', '--help'],
+            'findmy': ['screencapture', '-h']}
+
+
+def probe(kind, run=subprocess.run):
+    result = {'kind': kind, 'os': platform.system(), 'binary': False,
+              'startup': False, 'account': 'untested', 'permissions': 'untested',
+              'live_operation': 'untested'}
+    if result['os'] != 'Darwin':
+        return {**result, 'reason': 'macOS execution host required'}
+    argv = COMMANDS[kind]
+    result['binary'] = bool(shutil.which(argv[0]))
+    if not result['binary']:
+        return {**result, 'reason': 'missing-command'}
+    try:
+        response = run(argv, capture_output=True, text=True, timeout=10, check=False)
+    except (OSError, subprocess.TimeoutExpired):
+        return {**result, 'reason': 'startup-failed'}
+    text = response.stdout + response.stderr
+    result['startup'] = response.returncode == 0 or (kind == 'findmy' and 'screencapture' in text and '-l' in text)
+    result['exit_code'] = response.returncode
+    if kind == 'reminders':
+        result['alarm_supported'] = '--alarm' in text
+    if kind == 'imessage':
+        result['send_flags_supported'] = all(flag in text for flag in ('--to', '--file', '--service'))
+    result['reason'] = 'help-only-not-ready-for-live-operation' if result['startup'] else 'startup-failed'
+    return result
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('kind', choices=COMMANDS)
+    args = parser.parse_args()
+    result = probe(args.kind)
+    print(json.dumps(result))
+    raise SystemExit(0 if result['startup'] else 1)

package/built-in-skills/prismer-ascii-video/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nous Research
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/built-in-skills/prismer-ascii-video/LICENSE.hermes

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nous Research
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/built-in-skills/prismer-ascii-video/PROVENANCE.md

@@ -0,0 +1,7 @@
+# Resource provenance
+
+Imported from hermes-agent skills/creative/ascii-video at 1a1f4a59e252e1dc0137e7b2e7bcc8b0381d19c4.
+
+Prismer receiver: prismer-ascii-video. Native replacement: ascii-video; this is not an alias. Preserve all source resources at their relative paths; merge packs live under references/ascii-video/. Source file hashes and content review: docs/bugfix223/audit-creative-media-coverage.json. Local corrections and remaining live acceptance: docs/bugfix223/implementation-creative.md.
+
+LICENSE.hermes preserves Nous Research MIT terms. External libraries, fonts, services and media have separate licenses; no third-party binary assets were included.