SAF Documentation

Appearance

product/init ​

Source ​

init.ts

Usage ​

bash
npm exec saf-workflow kickoff product/init <name> <domain> [--productOnly]

To run this workflow automatically, tell the agent to:

  1. Navigate to the target package
  2. Run this command
  3. Follow the instructions until done

Checklist ​

When run, the workflow will:

  • Add foo/** and deploy workspaces in package.json
  • Run npm exec prettier -- package.json --write
  • Upsert 382 templates.
  • Run node --experimental-strip-types --disable-warning=ExperimentalWarning /Users/scott/src/saf-2025/saflib/product/workflows/strip-stub-tsconfig-refs.ts /Users/scott/src/saf-2025/saflib/foo
  • Upsert 422 templates.
  • Upsert 435 templates.
  • Add foo vitest projects to root vitest.config.ts
  • Rewrite base/dev compose volumes for product monorepo layout
  • Run rm -rf .github/workflows/playwright.yml .github/workflows/typecheck.yml .github/workflows/push.yml .github/workflows/security.yml .github/actions/setup-node-deps
  • Run mv /Users/scott/src/saf-2025/saflib/deploy/remote-assets/env.foo.secrets /Users/scott/src/saf-2025/saflib/deploy/remote-assets/.env.foo.secrets
  • Change working directory to ..
  • Run npm exec saf-monorepo -- lock-prune --yes --root /Users/scott/src/saf-2025
  • Run npm install
  • Run node --experimental-strip-types --disable-warning=ExperimentalWarning /Users/scott/src/saf-2025/saflib/product/workflows/regenerate-product-env.ts /Users/scott/src/saf-2025/saflib/foo
  • Change working directory to foo/dev
  • Run touch ./.env
  • Change working directory to
  • Run npm exec saf-imports tsconfig generate -- --write
  • Run node --experimental-strip-types --disable-warning=ExperimentalWarning /Users/scott/src/saf-2025/saflib/product/workflows/reset-product-db-migrations.ts /Users/scott/src/saf-2025/saflib/foo/service/db
  • Change working directory to foo/service/db
  • Run npm run generate
  • Change working directory to ..
  • Run npm exec saf-monorepo -- lock-prune --yes --root /Users/scott/src/saf-2025
  • Run npm install
  • Run node --experimental-strip-types --disable-warning=ExperimentalWarning /Users/scott/src/saf-2025/saflib/product/workflows/generate-product-specs.ts /Users/scott/src/saf-2025/saflib/foo
  • Change working directory to deploy
  • Run npm run regen-kratos-secrets
  • Run npm run generate

Help Docs ​

bash
Usage: npm exec saf-workflow kickoff product/init <name> <domain> [--productOnly]

Create a new product

Arguments:
  name        Name of the new product
              Example: "foo"
  domain      Domain of the new product
              Example: "example.com"
  productOnly Copy only the golden product tree (skip deploy/scaffold/kratos). Used by CI smoke tests. (optional flag)