Commit Graph

189 Commits

Author SHA1 Message Date
irl-dan 0fac4805a7 sqlite state management, more examples 2026-01-16 02:36:03 -05:00
irl-dan f9d7ae859e directory restructuring, documentation 2026-01-16 01:48:24 -05:00
irl-dan 9f96b0a04b persistence layer and context mgmt improvements 2026-01-16 00:48:24 -05:00
irl-dan 189dfe5661 Merge branch 'jeffscottward-feat' into dev
# Conflicts:
#	README.md
2026-01-14 21:47:27 -05:00
irl-dan cf39209505 improve path discovery and add captains chair examples 2026-01-14 20:52:56 -05:00
irl-dan 4e2f8300e8 chore: update telemetry URLs to api-v2.prose.md
- Update PRIVACY.md data storage URL
- Update SKILL.md analytics endpoint URLs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 10:48:58 -05:00
irl-dan 0af4feeedb fix(skill): remove invalid frontmatter keys from SKILL.md
Remove `see-also` and `triggers` keys that aren't in the allowed
set (name, description, license, allowed-tools, compatibility, metadata).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 08:01:52 -05:00
irl-dan 5335e26807 docs: update install instructions for all platforms
- Change Claude Code instructions to use `claude` CLI format
- Add OpenCode instructions (git clone to ~/.config/opencode/skill/)
- Add Amp instructions (git clone to ~/.config/agents/skills/)
- Remove "restart Claude Code" step
- Update example prompt to "run example prose program..."

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 09:14:57 -05:00
irl-dan a4f02f1e28 feat: add program composition syntax and automatic state management
Program Composition:
- Add `use "@handle/slug" as alias` for importing programs
- Add `input name: "description"` for declaring program inputs
- Add `output name = expr` for marking outputs at assignment time
- Add program invocation with `alias(input: value)` syntax
- Add destructuring: `let { a, b } = program(...)`
- Programs fetched from p.prose.md registry

State Management:
- Remove experimental/beta warnings from file-based state
- VM now automatically selects state mode based on program complexity
- Criteria: statement count, parallel branches, imports, nesting, duration
- VM announces choice with override instructions (--state=file/context)
- Add in-program directive: `# state: file`

Telemetry:
- Add run-start notice when telemetry enabled
- Show friendly message with --no-telemetry disable instruction

Cleanup:
- Remove onboarding/boot menu section from SKILL.md
- Update narration protocol with 📥/📤/🔗 markers
- Update directory structure with inputs/outputs/imports folders

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 23:40:36 -05:00
irl-dan 74d21efc56 Merge pull request #10 from maxtheman/patch-1
Update README.md
2026-01-09 23:32:23 -05:00
Max Caldwell 47c7e3d614 Update README.md
More correct copy/paste instructions
2026-01-09 14:51:47 -08:00
irl-dan 651ad4e13f fix outdated reference in docs.md 2026-01-08 12:10:17 -05:00
irl-dan bf075a281a feat: add Gas Town multi-agent orchestration example
Implements Steve Yegge's Gas Town architecture as example 28:
- 7 worker roles (Mayor, Polecat, Refinery, Witness, Deacon, Dog, Crew)
- MEOW stack (Beads, Epics, Molecules, Protomolecules, Formulas, Wisps)
- GUPP (Gas Town Universal Propulsion Principle)
- NDI (Nondeterministic Idempotence)
- Patrols, Convoys, Swarms, War Rigs
- CV chains, activity feeds, mail system
- Shiny/Chrome quality workflows
- Hanoi/MAKER demo for million-step workflows

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 23:01:09 -05:00
irl-dan bc29b14ee1 Merge pull request #6 from rvantonder/patch-1
readme: easier clone with https
2026-01-07 19:33:59 -05:00
Jeff Scott Ward 2f7e6a24f1 feat: implement native OpenCode plugin and tests
This adds the native OpenCode plugin infrastructure, comprehensive tests, and a new automated PR review example. It also updates the README with installation instructions for OpenCode.
2026-01-07 19:00:18 -05:00
Rijnard van Tonder 1b3b181dbf readme: easier clone with https 2026-01-07 21:55:12 +02:00
irl-dan 09bc3b07d0 docs: add patterns and antipatterns guides for OpenProse
Add two companion documents to the OpenProse skill:
- patterns.md: 30 best practice rules for robust, efficient, and
  maintainable agent orchestration
- antipatterns.md: 25 anti-patterns to avoid with remediation guidance

Both follow a lint-rule format with named rules and prose code examples.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 12:17:16 -05:00
irl-dan c2dd8a475a Add VM mechanism explanation and Prose Complete terminology
- prose.md: Add "Why This Is a VM" section explaining the simulator
  mechanism, component mapping table, and "simulation with sufficient
  fidelity is implementation" insight
- SKILL.md: Add condensed simulator explanation to intro
- README.md: Add simulator framing to "How It Works" section and
  introduce "Prose Complete" terminology

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 14:32:29 -05:00
irl-dan 9b3edd36bf Add persistent USER_ID for cross-session user tracking
- USER_ID: permanent anonymous identifier (never changes)
- SESSION_ID: per-session identifier (regenerates after 1 hour)
- Both IDs stored in .prose/state.json
- Both IDs included in all telemetry events
- Enables tracking usage patterns per user across sessions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 10:55:58 -05:00
irl-dan 968fcc1ef1 Fix telemetry session ID and remove opt-in friction
- Session ID now stored in .prose/state.json and reused across events
- Added Step 0 to boot flow: initialize session before user interaction
- Telemetry now enabled by default (no prompt during onboarding)
- Users can opt-out anytime by saying "disable telemetry" or editing state.json
- This fixes the issue where each event had a different session ID

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 10:51:33 -05:00
irl-dan e4b72a4e51 Fix telemetry documentation and add boot event tracking
- Add session hash generation instructions for Claude
- Add boot event for tracking OpenProse starts
- Add silent telemetry guidance (don't block user, ignore errors)
- Use -s flag for curl to suppress output

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-04 22:34:15 -05:00
irl-dan f3ffebd704 Update docs to use /prose-boot slash command v0.3.1 2026-01-03 19:53:04 -05:00
irl-dan 1a8cae81f6 Add slash commands: /prose-boot, /prose-compile, /prose-run v0.3.0 2026-01-03 19:29:20 -05:00
irl-dan 65bf50fb1b Add restart instruction after plugin install v0.2.4 2026-01-03 11:00:50 -05:00
irl-dan 14fbc43618 Rename marketplace to 'prose' for consistency with repo name v0.2.3 2026-01-03 10:51:25 -05:00
irl-dan d7b85be464 Fix repository field: object → string v0.2.2 2026-01-03 10:42:05 -05:00
irl-dan 9607f65078 Fix source path: '.' → './' v0.2.1 2026-01-03 10:35:57 -05:00
irl-dan fdcd3995aa Fix install command: open-prose@open-prose v0.2.0 2026-01-03 09:59:30 -05:00
irl-dan a18b119a8e Update privacy policy opt-out language, rename interpreter.md to prose.md
- Privacy: Clarify that opt-out relies on nondeterministic computer
- Rename interpreter.md → prose.md for clarity
- Update docs.md references accordingly

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:56:54 -05:00
irl-dan 90fbed7b38 Add beta warning, legal documents, and disclaimers
- Add LICENSE (MIT)
- Add PRIVACY.md (telemetry disclosure, opt-out instructions)
- Add TERMS.md (liability disclaimers, user responsibility)
- Add beta warning badge at top of README linking to Beta & Legal section
- Add disclaimer after install instructions
- Add comprehensive Beta & Legal section at bottom of README

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:51:00 -05:00
irl-dan 1176b954c5 Rename prose.md to docs.md
Update all references across:
- SKILL.md (frontmatter, triggers, documentation table)
- interpreter.md (frontmatter see-also)
- README.md (links)
- examples/README.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:45:12 -05:00
irl-dan 59ad6d1a6e Simplify getting started: use openprose boot
Replace verbose example prompts with single `openprose boot` command.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:38:43 -05:00
irl-dan 94c1c1bd04 Add SVG header asset with relative path
GitHub strips inline SVGs for security. Host the SVG as a file
and reference with relative path instead.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:26:25 -05:00
irl-dan f867ecee8e Replace broken SVG URL with inline SVG header
The external SVG asset URL was returning 404. Replaced with
inline SVG that matches the landing page design system:
- Paper cream background with subtle texture
- Two-tone "Open Prose" title
- Gold accent underline
- Typewriter margin line detail
- Corner flourishes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:25:10 -05:00
irl-dan 6176e3e03e Standardize terminology: Orchestrator → OpenProse VM
- Rename interpreter.md title to "OpenProse VM"
- Add "Embodying the VM" section with identity framing
- Add "The VM as Intelligent Container" subsection (IoC concept)
- Add frontmatter to interpreter.md and prose.md with cross-references
- Add openprose compile/run triggers to SKILL.md with descriptions
- Update README.md section "The Orchestrator" → "The OpenProse VM"
- Standardize all "orchestrator" references to "OpenProse VM" across docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 09:18:46 -05:00
irl-dan be83050a69 Add state management and interactive boot menu
- interpreter.md: Comprehensive state tracking with two systems
  - In-context (default): Structured narration protocol with emoji markers
  - In-file (beta): Filesystem persistence for long programs

- SKILL.md: Add telemetry and interactive boot menu
  - Opt-in telemetry with api.prose.md analytics
  - Boot flow for new users (2-4 questions → generate .prose)
  - Returning user flow (scan files → tailored guidance)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 08:08:27 -05:00
irl-dan 675f89e84f Align prose.md opening with tenets
Use 'programming language for AI sessions' consistently with README and SKILL.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 07:05:26 -05:00
irl-dan c9979b1422 Improve SKILL.md activation guidance
- Clarify when to use: orchestrating multiple subagents
- Add instruction to embody the Orchestrator from interpreter.md
- Update intro to match tenets language

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 06:46:52 -05:00
irl-dan d97fd91ac6 Initial commit: OpenProse skill
Ships as markdown files with zero dependencies:
- SKILL.md: Activation and quick reference
- interpreter.md: Execution semantics
- prose.md: Full language specification (compiler + validator)
- 27 examples

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 06:44:22 -05:00