@jnyross/code-factory 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 snarktank
+
+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,88 @@
+# Code Factory Template
+
+A private-first template for running Ryan Carson-style "Ralph" autonomous loops with local CLI tooling and flat-rate subscriptions.
+
+## Zero-API Cost Principle
+This template is built to avoid extra API token costs:
+- Use local CLI agents (Claude Code CLI, Cursor Ultra agent mode, Antigravity, GLM coding plan, Minimax coding plan, ChatGPT Pro workflows).
+- Do not add direct token-billed API calls in repository scripts.
+- Keep all automation in repo-native shell scripts and CI.
+
+## Core Loop Files
+- `ARCHITECTURE.yaml`: Machine-readable architecture contract.
+- `AGENTS.md`: Shared autonomous loop policy.
+- `prd.json`: Task queue for agents.
+- `progress.txt`: Append-only execution journal.
+
+## Tool Rule Files
+- `.cursorrules`: Cursor Ultra native behavior.
+- `CLAUDE.md`: Claude Code CLI behavior.
+- `.agent/rules/CodeFactory.md`: Antigravity/GLM/Minimax behavior.
+- `prompt_template.txt`: ChatGPT Pro project-manager prompt.
+
+## Local Runner
+`ralph.sh` is rewritten to use local CLI tools only.
+
+Runner behavior:
+1. Reads next open task from `prd.json`.
+2. Invokes a local agent CLI for implementation (`codex` by default).
+3. Runs preflight checks:
+   - `npm run typecheck`
+   - `npm run lint`
+   - `npm test`
+4. Appends progress to `progress.txt`.
+5. Marks task done only when preflight passes.
+
+Engine selection:
+- Default: `codex` (`AGENT_ENGINE=codex`).
+- Claude: `AGENT_ENGINE=claude`.
+- OpenCode: `AGENT_ENGINE=opencode` (defaults to `minimax-coding-plan/MiniMax-M2.5`).
+- Custom CLI: `AGENT_ENGINE=custom AGENT_CMD='<your command>'`.
+
+Examples:
+```bash
+./ralph.sh --once
+AGENT_ENGINE=claude ./ralph.sh --once
+AGENT_ENGINE=opencode ./ralph.sh --once
+OPENCODE_MODEL=minimax-coding-plan/MiniMax-M2.5 AGENT_ENGINE=opencode ./ralph.sh --once
+AGENT_ENGINE=custom AGENT_CMD='your-cli --non-interactive -' ./ralph.sh --once
+```
+
+Preflight directory selection:
+- First choice: repository root.
+- Fallback: `flowchart/` (included in this base template).
+- Override with `PROJECT_DIR=/path/to/app`.
+
+## CI Safety Layer
+- `.github/workflows/preflight.yml`
+  - Labels risky PRs as `high-risk` when touching paths like `db/`, `auth/`, or `infra/`.
+  - Runs typecheck/lint/tests in root or fallback `flowchart/`.
+- `.github/workflows/auto-review.yml`
+  - Adds or updates a secondary agent-review comment on PRs.
+
+## New Project Bootstrap
+Use the CLI to create a fresh repo from this template with clean git history.
+
+Example:
+```bash
+code-factory my-next-app ~/Projects
+```
+
+Global install:
+```bash
+npm install -g @jnyross/code-factory
+```
+
+Compatibility alias:
+- `new-project` points to the same CLI command as `code-factory`.
+
+## Suggested Working Loop
+1. Copy `prd.json.example` to `prd.json` (already present in this template).
+2. Add real tasks to `prd.json`.
+3. Run `./ralph.sh --once` for a single task cycle or `./ralph.sh` for looped operation.
+4. Review `progress.txt` after each run.
+5. Open PR and require preflight workflow success before merge.
+
+## Notes
+- This template assumes a Node/TypeScript project with `typecheck`, `lint`, and `test` scripts.
+- If you use different commands, update `ralph.sh`, `ARCHITECTURE.yaml`, and workflow files together.

package/bin/code-factory.mjs

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+import { execFileSync } from "node:child_process";
+import { existsSync, rmSync } from "node:fs";
+import { resolve } from "node:path";
+import process from "node:process";
+
+const TEMPLATE_URL =
+  process.env.CODE_FACTORY_TEMPLATE_URL ??
+  "https://github.com/jnyross/code-factory-template.git";
+
+function usage(exitCode = 0) {
+  console.log(`Usage:
+  code-factory <project-name> [destination-directory]
+  code-factory new <project-name> [destination-directory]
+
+Examples:
+  code-factory my-app
+  code-factory "Youth Reg Response Platform" ~/Software_Projects
+
+Environment:
+  CODE_FACTORY_TEMPLATE_URL  Override template repository URL
+`);
+  process.exit(exitCode);
+}
+
+function run(cmd, args) {
+  execFileSync(cmd, args, { stdio: "inherit" });
+}
+
+const rawArgs = process.argv.slice(2);
+
+if (rawArgs.length === 0 || rawArgs.includes("-h") || rawArgs.includes("--help")) {
+  usage(0);
+}
+
+let args = rawArgs;
+if (args[0] === "new") {
+  args = args.slice(1);
+}
+
+if (args.length < 1 || args.length > 2) {
+  usage(1);
+}
+
+const projectName = args[0];
+const destinationDir = args[1] ?? process.cwd();
+const targetPath = resolve(destinationDir, projectName);
+
+if (existsSync(targetPath)) {
+  console.error(`Target already exists: ${targetPath}`);
+  process.exit(1);
+}
+
+try {
+  run("git", ["clone", TEMPLATE_URL, targetPath]);
+  rmSync(resolve(targetPath, ".git"), { recursive: true, force: true });
+  run("git", ["-C", targetPath, "init", "-q"]);
+  run("git", ["-C", targetPath, "add", "."]);
+  run("git", ["-C", targetPath, "commit", "-q", "-m", "Initial commit from Code Factory template"]);
+
+  console.log("Your new Code Factory project is ready!");
+  console.log(`Path: ${targetPath}`);
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`code-factory failed: ${message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@jnyross/code-factory",
+  "version": "1.0.0",
+  "description": "Bootstrap new repos from the Code Factory template.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jnyross/code-factory-template.git"
+  },
+  "homepage": "https://github.com/jnyross/code-factory-template#readme",
+  "bugs": {
+    "url": "https://github.com/jnyross/code-factory-template/issues"
+  },
+  "keywords": [
+    "code-factory",
+    "template",
+    "bootstrap",
+    "cli",
+    "ai",
+    "devops"
+  ],
+  "bin": {
+    "code-factory": "bin/code-factory.mjs",
+    "new-project": "bin/code-factory.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}