@joynt/foundry 0.1.51 → 0.1.53

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joynt Shops
+
+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/README.md

@@ -0,0 +1,70 @@
+# Joynt Foundry
+
+Foundry turns a GitHub Issue into a verified pull request. Comment `@foundry go` on an issue and Foundry claims it, runs a coding agent in an isolated git worktree, runs your verify commands, opens a PR into your integration branch, and stands up a preview if you have one. Humans review on GitHub. Three comments are the whole control surface: `@foundry go`, `@foundry restart`, `@foundry stop`. Every other comment is context the agent reads; labels show status.
+
+Foundry is a **GitHub Action**. There is no server to run and no machine to keep awake. Each GitHub event that matters starts a job, the job performs one transition of the task's state machine, and state lives on GitHub: in labels, a structured claim comment, the PR, and the preview comment.
+
+Foundry is the orchestration layer, not the agent. It runs Claude Code, aider, or any CLI you configure, and bills your own Claude subscription through `CLAUDE_CODE_OAUTH_TOKEN`.
+
+## What this package is for
+
+This package is the Foundry CLI. The Action itself is referenced from your workflow as `joyntshops/foundry@v0` and builds inside the job, so nothing needs to be installed to run Foundry. The CLI is for:
+
+- **Setup**: `init` scaffolds a repository; `setup-bot` creates the GitHub App that gives Foundry an identity.
+- **Operating on a task** from any checkout: `reset`, `preview up` / `down` / `status`.
+- **The integration branch**: `review`, `release`, `sync-integration`.
+
+It needs Node 18 or later, git, and `gh` authenticated with `gh auth login`.
+
+## Quick start
+
+```bash
+npx @joynt/foundry init
+```
+
+1. **Scaffold.** From a clone, `init` writes `.joynt-foundry.yml`, `.github/workflows/foundry.yml`, and an issue template, and creates the `state:*` and `mode:*` labels. Set `branches:` to the branches you already deploy from; nothing is renamed.
+2. **Secrets.** Add `CLAUDE_CODE_OAUTH_TOKEN` from `claude setup-token`. Run `npx @joynt/foundry setup-bot` and add the two App secrets it prints; without the App, PRs the agent opens get no CI.
+3. **Push** to the default branch. Foundry listens from there.
+4. **Go.** Open an issue, comment `@foundry go`, and watch Actions → Foundry.
+
+The full walkthrough is in [Onboarding](https://github.com/joyntshops/foundry/blob/main/docs/foundry/onboarding.md).
+
+## The loop
+
+```
+human comments @foundry go on an issue
+  → claim (state:in-progress + claim comment)
+  → worktree from origin/<integration branch>
+  → agent runs; transcript is the job log
+  → the agent's typed report: done · needs input · plan ready · blocked
+  → verify (lint, typecheck, build, test); no PR until green
+  → PR into integration · state:ready-for-human-review · preview up
+human reviews; @foundry go <feedback> or "request changes" sends the agent back to the branch
+approve → Foundry rebases, waits for checks, merges → state:done · preview down
+```
+
+## Install globally
+
+```bash
+npm install -g @joynt/foundry
+foundry --version
+```
+
+Merges to `main` publish a new patch version automatically. The CLI version and the Action ref a workflow pins can differ; nothing depends on them matching.
+
+## Documentation
+
+- [Overview](https://github.com/joyntshops/foundry/blob/main/docs/foundry/overview.md): what Foundry does, what it does not, and the security model
+- [Installation](https://github.com/joyntshops/foundry/blob/main/docs/foundry/installation.md) · [Onboarding](https://github.com/joyntshops/foundry/blob/main/docs/foundry/onboarding.md)
+- [Writing a task](https://github.com/joyntshops/foundry/blob/main/docs/foundry/writing-a-task.md) · [Workflows](https://github.com/joyntshops/foundry/blob/main/docs/foundry/workflows.md)
+- [Configuration](https://github.com/joyntshops/foundry/blob/main/docs/foundry/config-reference.md) · [CLI](https://github.com/joyntshops/foundry/blob/main/docs/foundry/cli-reference.md) · [GitHub Action](https://github.com/joyntshops/foundry/blob/main/docs/foundry/github-action.md)
+- [Agent backends](https://github.com/joyntshops/foundry/blob/main/docs/foundry/agent-backends.md) · [Preview environments](https://github.com/joyntshops/foundry/blob/main/docs/foundry/preview-environments.md) · [Troubleshooting](https://github.com/joyntshops/foundry/blob/main/docs/foundry/troubleshooting.md)
+- [Releasing](https://github.com/joyntshops/foundry/blob/main/docs/foundry/releasing.md): how versions and tags are produced
+
+A public demo of a repository wired up end to end: [joyntshops/foundry-demo](https://github.com/joyntshops/foundry-demo).
+
+Source, issues, and contributing: [github.com/joyntshops/foundry](https://github.com/joyntshops/foundry).
+
+## License
+
+MIT.

package/package.json

@@ -1,7 +1,31 @@
 {
   "name": "@joynt/foundry",
-  "version": "0.1.51",
+  "version": "0.1.53",
   "description": "Developer automation: GitHub Issues → agent sessions → validated PRs",
+  "keywords": [
+    "github",
+    "github-actions",
+    "github-action",
+    "github-issues",
+    "pull-request",
+    "coding-agent",
+    "ai-agent",
+    "agent",
+    "claude",
+    "claude-code",
+    "automation",
+    "developer-tools",
+    "devops",
+    "workflow",
+    "code-review",
+    "preview-environment",
+    "orchestration"
+  ],
+  "homepage": "https://github.com/joyntshops/foundry#readme",
+  "bugs": {
+    "url": "https://github.com/joyntshops/foundry/issues"
+  },
+  "author": "Joynt Shops",
   "license": "MIT",
   "bin": {
     "foundry": "dist/cli.js"
@@ -10,7 +34,9 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "templates"
+    "templates",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsc",

package/templates/foundry.yml

@@ -106,7 +106,7 @@ jobs:
 
       - name: Foundry
         id: foundry
-        uses: joyntshops/foundry@main
+        uses: joyntshops/foundry@v0
         with:
           github-token: ${{ steps.app.outputs.token || github.token }}
           claude-code-oauth-token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}