Commit Graph

211 Commits

Author SHA1 Message Date
irl-dan eec7037dc3 refactor(open-prose): remove telemetry system
Telemetry was collecting anonymous usage analytics but is no longer needed.
Removes all telemetry-related code, config, and documentation including
USER_ID/SESSION_ID tracking, analytics endpoint calls, and migration steps
for legacy telemetry state files.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-23 08:23:43 -05:00
irl-dan fe0035d35a add interactive example 2026-01-22 20:51:44 -05:00
buck 54722504e4 Update examples link in README.md 2026-01-22 11:56:24 -06:00
irl-dan 4f5c2e61da add system-prompt 2026-01-21 10:36:16 -05:00
irl-dan e290da0173 feat(lib): add memory and analysis programs
Memory programs (recommend sqlite+ backend):
- user-memory.prose: Cross-project persistent personal memory
  with teach/query/reflect modes
- project-memory.prose: Project-scoped institutional memory
  with ingest/query/update/summarize modes

Analysis programs:
- cost-analyzer.prose: Token usage and cost pattern analysis
  with single/compare/trend scopes
- calibrator.prose: Validates light vs deep evaluation reliability
- error-forensics.prose: Root cause analysis for failed runs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 16:53:07 -05:00
irl-dan 0391894f01 feat(lib): add vm-improver and program-improver programs
Adds two new programs to the standard library that complete the
recursive improvement loop:

- vm-improver.prose: Analyzes inspection reports and proposes PRs
  to improve the OpenProse VM specification and implementation

- program-improver.prose: Analyzes inspection reports and proposes
  PRs to improve .prose source code (either in lib/ or external)

Together with inspector.prose, these enable a feedback cycle where
execution data drives improvements to both the VM and programs.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 16:17:07 -05:00
irl-dan d3a12e0c9b docs: simplify registry syntax - remove @ requirement
Registry references no longer require the @ prefix:
- `prose run irl-danb/habit-miner` (was: @irl-danb/habit-miner)
- `use "alice/research"` (was: "@alice/research")

Resolution rules updated:
- http:// or https:// → fetch directly
- Contains `/` but no protocol → resolve to p.prose.md
- Otherwise → local file path

Also includes user-scoped persistent agents (~/.prose/agents/).
2026-01-19 13:18:02 -05:00
irl-dan bb8e299047 feat(examples): improve skill security scanner with v2 patterns
- Add progressive disclosure: quick triage before deep scan
- Model tiering: Sonnet for checklist work, Opus for hard analysis
- Parallel scanners with graceful degradation (on-fail: continue)
- Persistent historian agent for scan history across runs
- Customizable inputs: mode (quick/standard/deep), focus, skill_filter
- Reusable blocks for scan workflow components
- Structured JSON output contracts for all agents
- Early alerting for critical findings mid-scan
- Batched processing to respect parallelism limits
2026-01-18 15:31:15 -05:00
irl-dan 808080dd98 docs: document remote program resolution and registry URL
- Add CLI commands section to prose.md
- Add remote programs documentation to both SKILL.md and prose.md
- Document resolution rules: direct URLs, @handle/slug shorthand, local files
- Clarify that p.prose.md is the only registry for @ shorthand

Fixes issue where model was hallucinating incorrect registry URLs.
v0.7.1
2026-01-18 15:09:14 -05:00
irl-dan 71ed17cc93 feat(plugin): add mid-program inputs and 8 new meta-level examples (v0.7.0)
This minor version release introduces mid-program inputs functionality,
enabling more interactive program execution flows. Also includes 8 new
meta-level examples demonstrating advanced OpenProse patterns.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v0.7.0
2026-01-18 12:43:19 -05:00
irl-dan 061d246a67 update docs references 2026-01-17 06:56:37 -05:00
irl-dan 948e0be3cb feat: add RLM example programs (40-43)
Recursive Language Model patterns for handling inputs beyond context limits:
- 40-rlm-self-refine: Recursive improvement until quality threshold
- 41-rlm-divide-conquer: Hierarchical chunking (100x context scaling)
- 42-rlm-filter-recurse: Cheap screening before expensive analysis
- 43-rlm-pairwise: O(n²) batched pair processing

Also includes examples 38-39 (skill-scan, architect-by-simulation).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v0.6.1
2026-01-16 13:46:36 -05:00
irl-dan 6e191bc6f1 chore: bump version to 0.6.0
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v0.6.0
2026-01-16 13:11:38 -05:00
irl-dan c3db1cfa38 feat: recursive blocks + PostgreSQL state backend
## Recursive Blocks (Ready for Implementation)
- VM-managed call stack with execution_id tracking
- Scope isolation per block invocation
- Support for divide-and-conquer, tree traversal, self-refining patterns
- Updated prose.md with Call Stack Management section
- Updated session.md with Execution Scope guidance
- Updated all state backends with scoped binding support

## PostgreSQL State Backend (Experimental)
- True concurrent writes with row-level locking
- Network access for external dashboards
- Scope resolution queries with recursive CTEs
- Security warnings about credential visibility
- Connection check procedure in SKILL.md

## Documentation
- Added sqlite/postgres see-also references across all docs
- Consistent execution_id handling in all state backends
- Updated README.md with security guidance

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 12:59:52 -05:00
irl-dan 4032b9a6f2 fix: simplify telemetry to avoid multiple bash prompts
- Remove prescriptive ID formats (timestamps, specific lengths)
- Instruct to use Write tool instead of bash for .env setup
- Move telemetry send to after program completion
- Add explicit rule: "telemetry must be invisible to the user"
- Reduce telemetry section from ~140 lines to ~50 lines

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v0.5.1
2026-01-16 04:16:32 -05:00
irl-dan d2fc4d7ec7 refactor: move examples into skill directory for proper path resolution
Plugins bundle files in a cache, and relative paths outside the skill
directory don't work. By moving examples from /examples/ to
/skills/open-prose/examples/, Claude can now find and run examples
without needing to resolve complex relative paths.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v0.5.0
2026-01-16 03:43:10 -05:00
irl-dan 6ca704adb9 fix: clarify single skill and bundled examples path resolution v0.4.4 2026-01-16 03:32:21 -05:00
irl-dan 04a3c374ce feat: add example resolution for natural language references v0.4.3 2026-01-16 03:28:59 -05:00
irl-dan 581110f43f feat: replace prose boot with prose help
- Add help.md with FAQs, syntax reference, and onboarding poll
- Remove prose boot command, add prose help as entry point
- Update command routing table
- Move FAQs and Teaching OpenProse sections to help.md
- Update telemetry references from boot to help events

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
v0.4.2
2026-01-16 03:20:54 -05:00
irl-dan a9bdcb0833 chore: bump version to 0.4.1 v0.4.1 2026-01-16 03:06:21 -05:00
irl-dan 528f6bc5f5 fix: improve skill discovery for any prose command 2026-01-16 03:05:58 -05:00
irl-dan a9835a4c3c add migration guide v0.4.0 2026-01-16 02:42:35 -05:00
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