@oaklandzoo/ostup 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oaklandzoo/ostup",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Scaffolds a new repo with the Ostup Agent Kit pre-installed: slash commands, doc templates, and a clean working state.",
   "type": "module",
   "bin": {

package/src/mvp-flow.mjs

@@ -19,6 +19,7 @@ import { REGISTRY, OPTIONAL_REGISTRY } from './templates.mjs';
 import { run as exec, isDryRun } from './exec.mjs';
 import { loadBrief, writeBriefFiles } from './brief/index.mjs';
 import { applyProfileOverlay } from './brief/profile-router.mjs';
+import { applyWhiteLabel } from './white-label.mjs';
 
 const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 const TEMPLATES_ROOT = resolve(PKG_ROOT, 'templates');
@@ -121,6 +122,13 @@ export async function runMvp({ flags = {}, cwd = process.cwd() } = {}) {
   await writeProjectEnvFiles({ targetDir, collected: creds.collected });
   await ensureGitignoreEnv({ targetDir });
 
+  if (flags.whiteLabel) {
+    const wl = await applyWhiteLabel({ targetDir });
+    if (wl.touched.length > 0) {
+      process.stdout.write(`[white-label] scrubbed OSTUP/Goodshin attribution in ${wl.touched.length} file(s)\n`);
+    }
+  }
+
   await exec('git-init',  'git', ['init'], { cwd: targetDir });
   await exec('git-branch','git', ['branch', '-M', 'main'], { cwd: targetDir });
   await exec('git-add',   'git', ['add', '.'], { cwd: targetDir });

package/src/scaffold.mjs

@@ -51,6 +51,14 @@ export async function scaffold({ targetDir, flags, stdinIsTTY = process.stdin.is
     await writeOne({ entry, absTarget, tokens });
   }
 
+  if (flags.whiteLabel) {
+    const { applyWhiteLabel } = await import('./white-label.mjs');
+    const wl = await applyWhiteLabel({ targetDir: absTarget });
+    if (wl.touched.length > 0) {
+      process.stdout.write(`[white-label] scrubbed OSTUP/Goodshin attribution in ${wl.touched.length} file(s)\n`);
+    }
+  }
+
   initGitIfNeeded(absTarget);
   printNextSteps(absTarget);
 }

package/src/templates.mjs

@@ -33,6 +33,7 @@ export const REGISTRY = [
   { src: '.claude/commands/break-into-stories.md', dest: '.claude/commands/break-into-stories.md' },
   { src: '.claude/commands/generate-brand-kit.md', dest: '.claude/commands/generate-brand-kit.md' },
   { src: '.claude/commands/generate-content-pack.md', dest: '.claude/commands/generate-content-pack.md' },
+  { src: '.claude/commands/handoff-package.md', dest: '.claude/commands/handoff-package.md' },
   { src: 'CLAUDE.md',                          dest: 'CLAUDE.md' },
   { src: 'AGENTS.md',                          dest: 'AGENTS.md' },
   { src: 'START_HERE.md',                      dest: 'START_HERE.md' },

package/src/white-label.mjs

@@ -0,0 +1,54 @@
+// white-label.mjs: post-process specific generated files to strip OSTUP / Goodshin attribution.
+// Used when `ostup init --white-label` is passed (Studio tier).
+
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const TARGETS = [
+  'AGENTS.md',
+  'README.md',
+  'START_HERE.md',
+  '.claude/commands/bootstrap.md',
+  '.claude/commands/prompt-start.md',
+  '.claude/commands/prompt-end.md',
+  '.claude/commands/preflight.md',
+];
+
+const REPLACEMENTS = [
+  { from: /Ostup Agent Kit/g, to: 'Project Kit' },
+  { from: /the Ostup Agent Kit/g, to: 'the Project Kit' },
+  { from: /scaffolded with ostup/gi, to: 'scaffolded' },
+  { from: /Built by Goodshin\.?/gi, to: '' },
+  { from: /Generated by `ostup brief`/g, to: 'Generated' },
+  { from: /Generated by `ostup [a-z-]+`/g, to: 'Generated' },
+  { from: /\bostup CLI subcommands.*\n/g, to: '' },
+  { from: /^\s*-\s*`ostup [a-z-]+`.*$/gm, to: '' },
+  { from: /\bnpx @oaklandzoo\/ostup [a-z-]+/g, to: 'project tooling' },
+  { from: /\(Vercel \+ GitHub \+ Goodshin\)/g, to: '(Vercel + GitHub)' },
+];
+
+export async function applyWhiteLabel({ targetDir } = {}) {
+  const touched = [];
+  for (const rel of TARGETS) {
+    const path = join(targetDir, rel);
+    if (!existsSync(path)) continue;
+    let body = await readFile(path, 'utf8');
+    let changed = false;
+    for (const rule of REPLACEMENTS) {
+      if (rule.to === undefined) continue;
+      const next = body.replace(rule.from, rule.to);
+      if (next !== body) {
+        body = next;
+        changed = true;
+      }
+    }
+    if (changed) {
+      // Collapse stray double blank lines that replacements may have left.
+      body = body.replace(/\n{3,}/g, '\n\n');
+      await writeFile(path, body, 'utf8');
+      touched.push(rel);
+    }
+  }
+  return { touched };
+}

package/templates/.claude/commands/handoff-package.md

@@ -0,0 +1,123 @@
+---
+description: Bundle the current project state into a single client-ready handoff document. Useful for agencies handing off a project to a client or a new developer. Writes docs/HANDOFF_PACKAGE.md and optionally calls `ostup export-pro` for the ZIP.
+---
+
+# /handoff-package
+
+The Studio-tier (or any operator's) equivalent of a one-page handoff summary. Distills the current state into a single Markdown doc that someone new to the project can read in 10 minutes and understand:
+
+- What this project is
+- What is shipped
+- What is in flight
+- How to run it locally
+- How to deploy
+- Who to ask about what
+
+## Step 1: read context
+
+```bash
+[ -f docs/brief.md ] && head -80 docs/brief.md
+[ -f HANDOFF.md ] && cat HANDOFF.md
+[ -f docs/PROJECT_STATE.md ] && cat docs/PROJECT_STATE.md
+[ -f docs/MANUAL_TASKS.md ] && cat docs/MANUAL_TASKS.md
+[ -f docs/ARCHITECTURE.md ] && cat docs/ARCHITECTURE.md
+[ -f README.md ] && head -40 README.md
+ls tasks/ 2>/dev/null
+git log --oneline -10
+```
+
+## Step 2: write `docs/HANDOFF_PACKAGE.md`
+
+```markdown
+# Handoff: <project name>
+
+> One-page client-ready overview. Generated <YYYY-MM-DD>.
+> If something here is wrong, the source of truth is `docs/brief.md` and the git log.
+
+## 1. What this project is
+
+<one paragraph from brief.summary + audience>
+
+## 2. Where it lives
+
+- **Repo:** <git remote URL>
+- **Live URL:** <from HANDOFF or brief>
+- **Latest commit:** <SHA + subject>
+
+## 3. What is shipped
+
+<from PROJECT_STATE "Recently done" + git log of last 10 commits>
+
+## 4. What is in flight
+
+<from HANDOFF "Active context" / "What to do next">
+
+## 5. How to run it locally
+
+```bash
+git clone <repo URL>
+cd <project>
+npm install
+cp .env.example .env.local   # fill in the values
+npm run dev
+```
+
+## 6. Environment variables required
+
+| Var | Purpose | Where to get it |
+|---|---|---|
+<list each from .env.example with brief purpose>
+
+## 7. How to deploy
+
+<from ARCHITECTURE.md or PROJECT_STATE — Vercel default; document any custom CI/CD>
+
+## 8. Profile and add-ons
+
+<from brief.scaffold.profile + brief.scaffold.addons; explain each add-on briefly>
+
+## 9. Blockers + things the operator must do manually
+
+<from MANUAL_TASKS.md "Active" section>
+
+## 10. Who to ask
+
+- **Project owner:** <from brief.project.owner_or_client>
+- **Last agent / dev:** <from HANDOFF if recorded>
+
+## 11. Recommended next steps for whoever picks this up
+
+1. Run `/preflight` to confirm Vercel + GitHub + env state.
+2. Run `/prompt-start` (or `/resume` if HANDOFF feels stale).
+3. Read `docs/brief.md` end to end.
+4. Pick the first item from "What is in flight" and confirm before changing anything.
+```
+
+## Step 3: optionally bundle into a ZIP
+
+Ask the operator: "Bundle into a ZIP via `ostup export-pro`?"
+
+If yes:
+
+```bash
+ostup export-pro --output handoff-<project>-$(date +%Y%m%d).zip
+```
+
+The ZIP includes `docs/HANDOFF_PACKAGE.md` plus the standard pro-export contents (brief, brand, content, initial PRD, agent kit).
+
+## Step 4: report
+
+```
+Handoff package: docs/HANDOFF_PACKAGE.md
+
+Optional bundle: handoff-<project>-<YYYY-MM-DD>.zip (run ostup export-pro to create)
+
+The recipient can read the package in ~10 minutes and pick up the work.
+```
+
+## Hard rules
+
+- Pull every fact from existing files (brief, HANDOFF, PROJECT_STATE, ARCHITECTURE, MANUAL_TASKS, git log). Do not invent.
+- If a section has no source, write `_TBD — operator to fill_` rather than guess.
+- This is a SNAPSHOT. Regenerate when you re-hand-off.
+- Operator can edit the file directly to refine; do not auto-regenerate on every session.

package/templates/AGENTS.md

@@ -29,7 +29,7 @@ Operator materials live in `{{INPUTS_PATH}}`. Read `{{INPUTS_PATH}}README.md` fo
 
 Session lifecycle: `/bootstrap`, `/prompt-start`, `/prompt-mid`, `/prompt-end`, `/preflight`, `/resume`, `/handoff-doctor`
 
-Building: `/create-prd`, `/break-into-stories`, `/generate-tasks`, `/update-image`, `/update-gui`, `/update-backend`, `/add-storage`, `/generate-image-prompt`, `/generate-image`
+Building: `/create-prd`, `/break-into-stories`, `/generate-tasks`, `/update-image`, `/update-gui`, `/update-backend`, `/add-storage`, `/generate-image-prompt`, `/generate-image`, `/generate-brand-kit`, `/generate-content-pack`, `/handoff-package`
 
 See each file under `.claude/commands/` for the full routine.
 
@@ -38,6 +38,8 @@ See each file under `.claude/commands/` for the full routine.
 - `ostup brief` — 10-question operator intake; writes `docs/brief.md`, `docs/brief.json`, `tasks/prd-initial-build.md`.
 - `ostup init --brief <path>` — scaffold using an existing brief.json; applies the matching profile overlay.
 - `ostup init` — interactive scaffold without brief.
+- `ostup init --white-label` — Studio tier; strips OSTUP/Goodshin attribution from generated docs.
+- `ostup export-pro` — bundle docs/brief + assets/brand + assets/content + initial PRD into a ZIP for client handoff.
 
 ## Helpers