@jnyross/code-factory 1.1.3 → 1.1.5

package/README.md

@@ -71,12 +71,15 @@ npm run harness:ui:capture-browser-evidence
 npm run harness:ui:verify-browser-evidence
 npm run harness:risk-tier
 npm run harness:weekly-metrics
+npm run spec:normalize
+npm run spec:validate
+npm run spec:check
 ```
 
 ## Branch Protection
 Merge blocking is enforced via GitHub branch protection requiring `risk-policy-finalize`.
 
-- `code-factory --github` now applies this automatically.
+- `code-factory` applies this automatically when it creates the GitHub repo (default behavior).
 - For repos created from GitHub template UI, run:
 
 ```bash
@@ -117,19 +120,19 @@ npm install -g @jnyross/code-factory
 ```
 
 ## Create a New Project
-Local only:
+Default (local scaffold + create/push GitHub repo):
 ```bash
 code-factory my-next-app ~/Projects
 ```
 
-Create + push GitHub repo in one command:
+Local only (opt out of GitHub creation):
 ```bash
-code-factory my-next-app ~/Projects --github --private
+code-factory my-next-app ~/Projects --no-github
 ```
 
 Examples:
 ```bash
-code-factory my-next-app --github --owner my-org --repo my-org/my-next-app --public
+code-factory my-next-app --owner my-org --repo my-org/my-next-app --public
 ```
 
 Compatibility alias:
@@ -142,6 +145,15 @@ Compatibility alias:
 - `opencode` (default model `minimax-coding-plan/MiniMax-M2.5`)
 - `custom`
 
+Before task execution, `ralph.sh` now runs a spec gate:
+1. normalize `ARCHITECTURE.yaml` + `prd.json` into canonical format
+2. validate both files strictly
+3. if still invalid, auto-repair with your selected local engine and retry (bounded)
+
+Defaults:
+- `SPEC_REPAIR_ENABLED=true`
+- `SPEC_REPAIR_MAX_RETRIES=3`
+
 Examples:
 ```bash
 ./ralph.sh --once

package/bin/code-factory.mjs

@@ -15,22 +15,24 @@ function usage(exitCode = 0) {
   code-factory new <project-name> [destination-directory] [options]
 
 Options:
-  --github              Create and push a new GitHub repo via gh CLI
-  --public              Use public visibility for --github
-  --private             Use private visibility for --github (default)
-  --owner <owner>       GitHub owner/org for --github (defaults to gh auth user)
+  --github              Create and push a GitHub repo via gh CLI (default)
+  --no-github           Skip GitHub creation and keep project local only
+  --public              Use public visibility for GitHub repo creation
+  --private             Use private visibility for GitHub repo creation (default)
+  --owner <owner>       GitHub owner/org (defaults to gh auth user)
   --repo <name|owner/name>
                         GitHub repo name override (default: slugified project name)
   --no-branch-protection
-                        Skip automatic main branch protection setup for --github
+                        Skip automatic main branch protection setup for GitHub creation
   --template-url <url>  Override template repository URL for this run
   -h, --help            Show help
 
 Examples:
   code-factory my-app
+  code-factory my-app ~/Software_Projects --no-github
   code-factory "Youth Reg Response Platform" ~/Software_Projects
   code-factory my-app ~/Software_Projects --github --private
-  code-factory my-app --github --owner my-org --repo my-org/my-app
+  code-factory my-app --owner my-org --repo my-org/my-app --public
 `);
   process.exit(exitCode);
 }
@@ -59,7 +61,7 @@ function slugify(name) {
 
 function parseArgs(rawArgs) {
   const options = {
-    github: false,
+    github: true,
     visibility: "private",
     owner: null,
     repo: null,
@@ -82,6 +84,11 @@ function parseArgs(rawArgs) {
       continue;
     }
 
+    if (arg === "--no-github") {
+      options.github = false;
+      continue;
+    }
+
     if (arg === "--public") {
       options.visibility = "public";
       continue;
@@ -157,6 +164,16 @@ function deriveGitHubRepo(projectName, options) {
   return { owner, repo };
 }
 
+function ensureGitHubCliReady() {
+  try {
+    runCapture("gh", ["auth", "status"]);
+  } catch {
+    throw new Error(
+      "GitHub creation is enabled by default. Run `gh auth login` first or pass --no-github for local-only setup."
+    );
+  }
+}
+
 function configureBranchProtection({ owner, repo }) {
   const requiredChecks = ["risk-policy-finalize"];
   const payload = {
@@ -209,6 +226,8 @@ function createProject(projectName, destinationDir, options) {
   run("git", ["-C", targetPath, "branch", "-M", "main"]);
 
   if (options.github) {
+    ensureGitHubCliReady();
+
     const { owner, repo } = deriveGitHubRepo(projectName, options);
     const fullRepo = `${owner}/${repo}`;
     const visibilityFlag = options.visibility === "public" ? "--public" : "--private";
@@ -227,6 +246,8 @@ function createProject(projectName, destinationDir, options) {
         );
       }
     }
+  } else {
+    console.log("GitHub repo creation skipped (--no-github).");
   }
 
   console.log("Your new Code Factory project is ready!");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jnyross/code-factory",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Bootstrap new repos from the Code Factory template.",
   "type": "module",
   "license": "MIT",
@@ -31,7 +31,10 @@
     "harness:ui:capture-browser-evidence": "node scripts/control-plane/capture-browser-evidence.mjs",
     "harness:ui:verify-browser-evidence": "node scripts/control-plane/verify-browser-evidence.mjs",
     "harness:ui:pre-pr": "npm run harness:ui:capture-browser-evidence && npm run harness:ui:verify-browser-evidence",
-    "harness:weekly-metrics": "node scripts/control-plane/weekly-metrics.mjs"
+    "harness:weekly-metrics": "node scripts/control-plane/weekly-metrics.mjs",
+    "spec:normalize": "node scripts/control-plane/normalize-specs.mjs --write",
+    "spec:validate": "node scripts/control-plane/validate-specs.mjs",
+    "spec:check": "npm run spec:normalize && npm run spec:validate"
   },
   "files": [
     "bin",