Skip to content

feat: consolidate Praxis skill and integrate Raptor lifecycle - #89

Draft
anshulsao wants to merge 2 commits into
mainfrom
feat/consolidated-praxis-skill
Draft

feat: consolidate Praxis skill and integrate Raptor lifecycle#89
anshulsao wants to merge 2 commits into
mainfrom
feat/consolidated-praxis-skill

Conversation

@anshulsao

@anshulsao anshulsao commented Sep 9, 2026

Copy link
Copy Markdown
Member

Summary

  • Ship one lazy-loaded praxis skill with its complete references, helper scripts and assets; route Facets configuration, imports, modules and releases to the independent raptor skill.
  • Install complete packages transactionally with scope-aware receipts, locking, recovery copies and safe reconciliation of exact legacy globals. Preserve modified/uncertain content, source symlinks and organization/personal namesakes.
  • Install a missing Raptor CLI and its canonical skill during explicit setup/login/refresh. Verify public binary downloads with SHA-256, export through an isolated staging home, and report partial setup accurately. Silent first-use bootstrap remains offline/Praxis-only.
  • Make praxis update / upgrade invoke raptor upgrade, including when Praxis is current or Homebrew-managed; report each outcome separately and defer embedded-skill refresh to the new Praxis binary.
  • Update prompt hooks and ig guidance to select canonical skill routes.
Praxis binary -> praxis skill -> task-specific references
Raptor binary -> raptor skill -> Facets operations
Agent Factory -> organization/personal skills (separate ownership)

Verification

  • go test -race -cover ./... -count=1 passed across all Go packages.
  • go vet ./..., gofmt checks and git diff --check passed.
  • All 10 offline skill/package/helper tests passed; canonical skill validation passed.
  • Independent skill-reader evaluations and code review are recorded in tests/skills/praxis/evaluation.md.
  • Actual installed development binaries: setup/repeat-setup passed; source trees matched; source symlinks and credentials preserved.
  • Real GitHub update rehearsal on isolated executable copies: Praxis 1.11.0 and nested Raptor 0.1.103 upgrade both succeeded.
  • Direct Raptor skill install/re-extraction passed with the local canonical bundle.

Draft / rollout prerequisites

Do not treat this draft as approval to release or deploy.

  1. Publish Raptor with the consolidated skill bundle first. A real missing-binary test downloaded public Raptor 0.1.103 successfully, but skill installation correctly failed because that release lacks the canonical package. Repeating an upgrade to that same release will not fix the missing bundle.
  2. Release the updated Praxis CLI before enabling unconditional legacy-global CLI unsharing in the companion Agent Factory change.
  3. The new server stops exporting all 30 replaced globals to every CLI version; old clients need the new distributions. Scoped organization/personal skills and hosted delivery remain separate.

Known existing limitation: the freshness parser recognizes only numeric x.y.z versions and reports a 0.development Raptor build as absent. This does not block the installation path and is not fixed here.

Companion Agent Factory draft: https://github.com/Facets-cloud/agent-factory/pull/1723

@coderabbitai

coderabbitai Bot commented Sep 9, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants