How krishnan-chandra/kstack works
kstack is a collection of personal Pi extensions. Its user-facing workflows include PR-stack publication and landing, bounded PR maintenance, session/history tools, model routing, and isolated parallel agents. The graph focuses on those runtime extensions and their shared support; README statements establish product behavior, while sampled excerpts and the source index support selected internal links. Unsampled implementation details and connections are omitted rather than inferred.
Main entry points: github-stacked-prs/index.ts GitHub stacks · jj-stacked-prs/index.ts Jujutsu stacks · api.ts Landing requests · pr-autopilot/index.ts PR autopilot
Components 25
Stacked PRs
- GitHub stacks
extensions/github-stacked-prs/index.ts - Graphite stacks
extensions/graphite-stacked-prs/index.ts - Jujutsu stacks
extensions/jj-stacked-prs/index.ts - Stack outcomes
extensions/shared/stack/outcome.ts
PR Workflows
- PR landing
extensions/land/index.ts - Landing requests
extensions/land/api.ts - PR autopilot
extensions/pr-autopilot/index.ts - Autopilot API
extensions/pr-autopilot/api.ts
Session Tools
- Session archive
extensions/session-archive/index.ts - Archive index
extensions/session-archive/archive-store.ts - Session handoff
extensions/handoff/index.ts - History search
extensions/handoff/history-search.ts
Agents and Routing
- Model routing
extensions/openrouter-routing/index.ts - Routing policy
extensions/openrouter-routing/routing-policy.ts - Parallel agents
extensions/parallel-agents/index.ts - Agent orchestration
extensions/parallel-agents/orchestrator.ts - Editor steering
extensions/steering-swap/index.ts
Shared Runtime
- Git command runner
extensions/shared/git-exec.ts - GitHub gateway
extensions/shared/github.ts - Repository identity
extensions/shared/github-repository.ts - Command guard
extensions/shared/command-fallthrough.ts - Boundary validation
extensions/shared/validation.ts
Other components
- Pi user
- Pi host
- GitHub
Connections 33
- Pi user → Pi host: uses extensions
README.md - Pi host → GitHub stacks: invokes commands
README.md - Pi host → Graphite stacks: invokes commands
README.md - Pi host → Jujutsu stacks: invokes tools
README.md - Pi host → PR landing: invokes landing
README.md - Pi host → PR autopilot: runs workflow
README.md - Pi host → Session archive: opens sessions
README.md - Pi host → Session handoff: starts handoff
README.md - Pi host → Model routing: routes models
README.md - Pi host → Parallel agents: runs agents
README.md - Pi host → Editor steering: handles editor input
README.md - GitHub stacks → GitHub: publishes PR stacks
README.md - Graphite stacks → GitHub: publishes PR stacks
README.md - Jujutsu stacks → GitHub: publishes native stacks
README.md - GitHub stacks → Landing requests: requests landing
extensions/github-stacked-prs/index.ts - Jujutsu stacks → Landing requests: requests landing
extensions/jj-stacked-prs/index.ts - Jujutsu stacks → Autopilot API: requests readiness
extensions/jj-stacked-prs/index.ts - GitHub stacks → Stack outcomes: records outcomes
extensions/github-stacked-prs/index.ts - Jujutsu stacks → Stack outcomes: renders outcomes
- PR landing → Landing requests: routes requests
extensions/land/index.ts - PR autopilot → Autopilot API: exposes requests
extensions/pr-autopilot/index.ts - Session archive → Archive index: indexes sessions
extensions/session-archive/index.ts - Session handoff → History search: provides search
extensions/handoff/index.ts - History search → Archive index: searches archive
extensions/handoff/history-search.ts - Model routing → Routing policy: applies policy
extensions/openrouter-routing/index.ts - Parallel agents → Agent orchestration: delegates runs
extensions/parallel-agents/index.ts - Repository identity → Git command runner: runs commands
extensions/shared/github-repository.ts - Repository identity → GitHub gateway: resolves repository
extensions/shared/github-repository.ts - GitHub gateway → Git command runner: executes requests
extensions/shared/github.ts - PR autopilot → Command guard: guards commands
extensions/pr-autopilot/index.ts - GitHub stacks → Command guard: guards commands
extensions/github-stacked-prs/index.ts - Landing requests → Boundary validation: validates payloads
extensions/land/api.ts - GitHub gateway → Boundary validation: checks responses
extensions/shared/github.ts