@catladder/cli 0.0.0-next-80fd0ab4 → 0.0.0-next-ebc933f2

package/dist/bundles/skills/catladder-cli/references/commands.md

@@ -0,0 +1,273 @@
+# catladder CLI command reference
+
+<!-- rendered from the command definitions by
+     cli/src/scripts/generateCliSkillReference.ts — do not edit -->
+
+All commands run non-interactively as `yarn catladder <command> ...`;
+see SKILL.md for how to pass inputs.
+
+## `catladder cloudsql restore-db`
+
+restore a db from one source to another target
+
+- `--source <value>`: Source instance (connection string or 'local')?
+- `--source-local-port <value>`: Local Port for source? (default: 5432)
+- `--source-username <value>`: Source Username? (default: "postgres")
+- `--source-password <value>`: Source Password?
+- `--source-db-name <value>`: Source DB name?
+- `--target <value>`: Target INSTANCE (connection string or 'local')?
+- `--target-local-port <value>`: Local Port for target? (default: 5432)
+- `--target-username <value>`: Target Username? (default: "postgres")
+- `--target-password <value>`: Target Password?
+- `--target-db-name <value>`: Target DB name?
+
+## `catladder fun dadjoke`
+
+something for jonas.
+
+## `catladder fun starwars`
+
+Long time ago... in a galaxy far far away...
+
+## `catladder k8s current-context`
+
+show current kubernetes context
+
+## `catladder k8s get-shell [namespace]`
+
+get a shell to a pod in the environment
+
+- `namespace` (positional): kubernetes namespace
+- `--pod-name <value>`: Which pod?
+
+## `catladder k8s list-namespaces`
+
+list all namespaces
+
+## `catladder k8s list-pods [namespace]`
+
+list all pods of namespace
+
+- `namespace` (positional): kubernetes namespace
+
+## `catladder k8s list-secrets [namespace]`
+
+show secrets
+
+- `namespace` (positional): kubernetes namespace
+
+## `catladder k8s port-forward [namespace]`
+
+start port-forwarding
+
+- `namespace` (positional): kubernetes namespace
+- `--pod-name <value>`: Which pod?
+- `--local-port <value>`: Local port:
+- `--remote-port <value>`: Remote port:
+
+## `catladder k8s stop-portforward [name]`
+
+stop a running port forward
+
+- `name` (positional): port forward name
+
+## `catladder k8s trigger-cronjob [namespace]`
+
+trigger cronjob
+
+- `namespace` (positional): kubernetes namespace
+- `--job-name <value>`: Which cronjob?
+
+## `catladder project ci job-log`
+
+Show a job's log
+
+- `--job-name <value>`: Which job?
+
+## `catladder project ci job-open`
+
+Open a Job
+
+- `--job-name <value>`: Which job?
+
+## `catladder project cloudsql proxy [envComponent]`
+
+proxy to cloud sql db
+
+- `envComponent` (positional): environment:component
+- `--local-port <value>`: Local port: (default: 54320)
+
+## `catladder project cloudsql restore-db`
+
+restores a project db from one source to another target
+
+- `--source <value>`: Source instance?
+- `--target <value>`: target env?
+- `--confirm-instance <value>`: confirm:
+
+## `catladder project config-secrets [envComponent]`
+
+setup/update secrets stored in pass
+
+- `envComponent` (positional): environment:component
+
+## `catladder project doctor [component]`
+
+Checks for drift between the config and the provisioned infrastructure (read-only): service accounts, IAM roles, gitlab tokens, github secrets, store entries.
+
+- `component` (positional): component name
+
+## `catladder project env-vars [envComponent]`
+
+list env vars
+
+- `envComponent` (positional): environment:component
+
+## `catladder project k8s delete [envComponent]`
+
+deletes a environment of a project (it deletes the namespace)
+
+- `envComponent` (positional): environment:component
+
+## `catladder project k8s delete-pods [envComponent]`
+
+delete / restart pods
+
+- `envComponent` (positional): environment:component
+- `--selected-pod-names <value>`: Which pods to delete / restart ?
+
+## `catladder project k8s get-shell [envComponent]`
+
+get a shell to a pod in the environment
+
+- `envComponent` (positional): environment:component
+- `--pod-name <value>`: Which pod?
+
+## `catladder project k8s list-pods [envComponent]`
+
+list pods of local project
+
+- `envComponent` (positional): environment:component
+
+## `catladder project k8s namespace [envComponent]`
+
+show namespace of local project
+
+- `envComponent` (positional): environment:component
+
+## `catladder project k8s pause [envComponent]`
+
+halts all running pods (scales to 0)
+
+- `envComponent` (positional): environment:component
+
+## `catladder project k8s trigger-cronjob [envComponent]`
+
+trigger cronjob
+
+- `envComponent` (positional): environment:component
+- `--job-name <value>`: Which cronjob?
+
+## `catladder project logs open [envComponent]`
+
+open logs for a component (Google Cloud Logging)
+
+- `envComponent` (positional): environment:component
+
+## `catladder project mongo destroy-member [envComponent]`
+
+DESTROY a member of a replicaset in order to reinitialize it
+
+- `envComponent` (positional): environment:component
+- `--pod-name <value>`: Which pod?
+
+## `catladder project mongo get-shell [envComponent]`
+
+get a shell to a mongodb in the environment
+
+- `envComponent` (positional): environment:component
+- `--pod-name <value>`: Which pod?
+
+## `catladder project mongo port-forward [envComponent]`
+
+port forward to a mongodb
+
+- `envComponent` (positional): environment:component
+- `--pod-name <value>`: Which pod?
+- `--local-port <value>`: Local port: (default: 30000)
+
+## `catladder project open env [envComponent]`
+
+open the live environment
+
+- `envComponent` (positional): environment:component
+
+## `catladder project open git`
+
+open the repo on gitlab / github in your browser
+
+## `catladder project port-forward [envComponent]`
+
+start port-forwarding
+
+- `envComponent` (positional): environment:component
+- `--pod-name <value>`: Which pod?
+- `--local-port <value>`: Local port:
+- `--remote-port <value>`: Remote port:
+- `--mr <value>`: Which mr
+
+## `catladder project renew-token`
+
+Configures the project access token for semantic release.
+
+## `catladder project secrets-clear-backups`
+
+clears all backups
+
+- `--keep <value>`: How many backups should we keep? (default: 1)
+
+## `catladder project secrets-sync-github [repo] [env]`
+
+copies all secrets from the vault to github repo secrets (same names), for the github pipeline
+
+- `repo` (positional): github repository (owner/name)
+- `env` (positional): only sync these environments (comma-separated, e.g. review,dev) — github allows at most 100 repo secrets
+
+## `catladder project security-evaluate`
+
+evaluate project's security audit document
+
+## `catladder project setup [component]`
+
+Initializes all environments and creates required resources, service accounts, etc.
+
+- `component` (positional): component name
+
+## `catladder project worktime`
+
+show the total worktime that you spent on a project
+
+## `catladder security audit ci-job [path] [token] [mainBranch] [projectId] [userId]`
+
+Evaluates security audit document. Creates MR with template if missing.
+
+- `path` (positional): path to project root
+- `token` (positional): GitLab token (api scope)
+- `mainBranch` (positional): main branch name
+- `projectId` (positional): GitLab project ID
+- `userId` (positional): GitLab user ID (assignee)
+
+## `catladder security audit create [token] [mainBranch] [projectId] [userId]`
+
+Creates a MR with the latest security audit template document
+
+- `token` (positional): GitLab token (api scope)
+- `mainBranch` (positional): main branch name
+- `projectId` (positional): GitLab project ID
+- `userId` (positional): GitLab user ID (assignee)
+
+## `catladder security audit evaluate [path]`
+
+Evaluates security audit document in given path
+
+- `path` (positional): path to project root

package/dist/bundles/skills/catladder-config/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: catladder-config
+description: Working with catladder, the framework that generates this repository's CI/CD pipelines (GitLab CI and/or GitHub Actions) from catladder.ts. Use when editing catladder.ts, adding or changing components, builds, deploys, environments or env vars, or when a change to generated pipeline files (.catladder-generated/, .gitlab-ci.yml, .github/workflows/) seems needed. Triggers on "catladder", "catladder.ts", "add a component", "change the pipeline", "deploy config".
+---
+
+# Working with catladder
+
+catladder generates this repository's CI/CD pipelines, deployments and
+environment files from the TypeScript config `catladder.ts` at the repo
+root. It is installed per project (`@catladder/cli`) — always use the
+locally installed version (`yarn catenv`, `yarn catladder`).
+
+## Golden rules
+
+1. **Never hand-edit generated files.** Everything under
+   `.catladder-generated/`, the generated parts of `.gitlab-ci.yml`, and
+   catladder-generated workflows under `.github/workflows/` are
+   overwritten on every regeneration (they carry a "generated by
+   catladder" header). To change them, change `catladder.ts` and
+   regenerate.
+2. **Regenerate after every `catladder.ts` change** by running
+   `yarn catenv`. With direnv set up, re-entering the project directory
+   does this automatically.
+3. **Commit the regenerated files together with the config change.**
+   Generated files are checked in; CI includes them directly.
+
+## Structure of catladder.ts
+
+```ts
+import type { Config } from "@catladder/cli";
+
+const config = {
+  appName: "my-app",
+  customerName: "pan",
+  pipelines: { gitlab: true, github: true }, // which CI systems to generate
+  components: {
+    www: {
+      dir: "frontend",          // working directory of this component
+      vars: { public: {}, secret: [] },  // env vars (see catladder-secrets skill)
+      build: { type: "node" },  // build types: node | rails | base
+      deploy: { type: "kubernetes" }, // kubernetes | google-cloudrun | dockerTag | custom
+      env: {                    // enable/customize per environment
+        review: {},
+        dev: {},
+        stage: false,           // false disables the env for this component
+        prod: {},
+      },
+    },
+  },
+} satisfies Config;
+
+export default config;
+```
+
+Key concepts:
+
+- **Components** are the sub-apps/services of the project (frontend,
+  api, ...). Each has a build config and a deploy config.
+- **Environments**: `dev` (deployed on push to the main branch),
+  `review` (per merge/pull request), `stage` and `prod` (deployed on
+  tagged releases), `local` (only for local development via catenv).
+  Per-env overrides live under `env.<name>` and can override vars,
+  deploy settings, and more.
+- **Pipelines**: `pipelines: { gitlab: true, github: true }` selects
+  which CI systems get generated files. Options objects instead of
+  `true` allow per-pipeline settings (e.g. `runnerVariables`).
+
+## Common tasks
+
+- **Add a component**: add an entry under `components`, run
+  `yarn catenv`, commit config + generated files.
+- **Change resources / deployment settings**: edit the component's
+  `deploy` (or per-env override), regenerate.
+- **Inspect the resulting pipeline**: read the generated files (e.g.
+  `.catladder-generated/gitlab/`, `.github/workflows/`) — but never
+  edit them.
+
+## Related skills
+
+- `catladder-secrets` — env vars and secret management
+- `catladder-pipelines` — how the generated pipelines work, debugging CI
+- `catladder-cli` — non-interactive CLI usage and command reference

package/dist/bundles/skills/catladder-pipelines/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: catladder-pipelines
+description: Understanding and debugging the CI/CD pipelines catladder generates (GitLab CI and GitHub Actions) — pipeline triggers, stages, environments, caching, job images, releases, and infrastructure drift. Use when investigating failing CI jobs, when asked why/when a job runs, when changing caching or job behavior, or when deployments misbehave. Triggers on "pipeline", "CI job", "gitlab-ci", "workflow", "deploy failed", "cache", "release".
+---
+
+# How catladder pipelines work
+
+All pipeline files are generated from `catladder.ts` — fix pipeline
+problems in the config (see `catladder-config` skill), never in the
+generated YAML.
+
+## Triggers and environments
+
+| Trigger | Runs on | Deploys to |
+|---|---|---|
+| `mainBranch` | push to the main branch | `dev` |
+| `mr` | merge/pull requests | `review` (one app per MR/PR) |
+| `taggedRelease` | git tags | `stage`, `prod` |
+
+Generated layout:
+
+- **GitLab**: `.gitlab-ci.yml` includes generated files from
+  `.catladder-generated/gitlab/` (one per trigger).
+- **GitHub**: workflows in `.github/workflows/` (generated ones carry a
+  "generated by catladder" header; others are unmanaged).
+
+Stages: setup → test → build → deploy → verify (post-deploy checks),
+plus stop jobs for review-app teardown.
+
+## Job images and catci
+
+Jobs run in catladder-provided images. With `jobImages: "repo"`, image
+definitions are materialized into `.catladder-generated/images/` and
+built in the project's own registry (content-hashed, rebuilt only on
+change). `.catladder-generated/catci/` holds a small bundled CI
+companion used by generated jobs (e.g. the release security audit) —
+all generated, never edit.
+
+## Caching
+
+Cache configuration is generated per build type; node builds cache
+`node_modules` and the yarn cache. GitLab uses mutable caches with
+fallback keys (review branches fall back to the dev cache); GitHub uses
+immutable lockfile-keyed caches where only the build job writes.
+Caching behavior is changed via the build config in `catladder.ts`,
+not in the YAML.
+
+## Releases
+
+With `releases` configured, tagged releases are created by a release
+job (method: `semantic-release` or `changesets`). The release job also
+runs a dependency security audit via catci.
+
+## Debugging CI
+
+Useful CLI commands (see the `catladder-cli` skill for invocation):
+
+- `yarn catladder project ci job-log` / `project ci job-open` — fetch
+  or open a CI job
+- `yarn catladder project doctor` — detect drift between `catladder.ts`
+  and the actually provisioned infrastructure (missing IAM roles, stale
+  secrets, ...). Run this when a deploy/teardown fails with permission
+  errors even though the config looks right; fix findings with
+  `yarn catladder project setup [component]`.
+- `yarn catladder project logs open`, `project k8s list-pods`,
+  `project k8s get-shell` — inspect the running deployments
+
+## Related skills
+
+- `catladder-config` — catladder.ts structure and regeneration
+- `catladder-secrets` — env vars and secret management
+- `catladder-cli` — non-interactive CLI usage and command reference

package/dist/bundles/skills/catladder-secrets/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: catladder-secrets
+description: Managing environment variables and secrets in a catladder project. Use when adding or changing env vars in catladder.ts (vars.public / vars.secret), when a secret value must be set or rotated, when secrets need syncing to GitHub, or when local .env / direnv environment questions come up. Triggers on "env var", "secret", "vars", "catenv", ".env", "config-secrets".
+---
+
+# Env vars and secrets with catladder
+
+Environment variables are declared per component in `catladder.ts`;
+secret *values* are never checked into the repo.
+
+## Declaring variables
+
+```ts
+components: {
+  app: {
+    vars: {
+      // names of secret vars — values are stored in the secrets vault, not in git
+      secret: ["API_KEY"],
+      public: {
+        MY_VAR: "some value",
+        // reference other vars, including from other components:
+        GRAPHQL_ENDPOINT: "${api:ROOT_URL}/graphql",
+      },
+    },
+  },
+}
+```
+
+Predefined per component/env: `ROOT_URL`, `HOSTNAME`, `PORT` (plus
+deploy-type specific ones). All vars are available at build time and at
+runtime. After changing declarations, regenerate with `yarn catenv` and
+commit.
+
+## Setting secret values
+
+Secret values are managed through the catladder CLI — never by editing
+files in the repo:
+
+```sh
+yarn catladder project config-secrets
+```
+
+This opens all env vars as YAML in `$EDITOR` (use e.g.
+`EDITOR="code --wait"`); on save, catladder upserts the changed values
+into the secrets vault. **An agent cannot drive this interactive
+editor** — when a new secret *value* is needed, add the name to
+`vars.secret`, regenerate, and ask the user to run
+`project config-secrets` themselves.
+
+## GitHub pipelines
+
+GitHub Actions cannot read the vault at runtime; secrets are mirrored
+into GitHub *environment* secrets (one GitHub environment per catladder
+env). Sync them with:
+
+```sh
+yarn catladder project secrets-sync-github
+```
+
+Run this after adding/changing secrets when a github pipeline is
+enabled.
+
+## Local development
+
+`catenv` generates the local env (`.env` files / exported vars via
+direnv) for the `local` environment. If a var is missing locally,
+check its declaration in `catladder.ts` and re-run `yarn catenv` before
+suspecting anything else.
+
+## Related skills
+
+- `catladder-config` — general catladder.ts structure and regeneration
+- `catladder-pipelines` — how the generated pipelines work
+- `catladder-cli` — non-interactive CLI usage and command reference

package/dist/cli/src/scripts/generateCliSkillReference.d.ts

@@ -0,0 +1 @@
+export declare const renderCliReference: () => string;

package/dist/cli/src/scripts/generateCliSkillReference.js

@@ -0,0 +1,87 @@
+"use strict";
+
+var __createBinding = this && this.__createBinding || (Object.create ? function (o, m, k, k2) {
+  if (k2 === undefined) k2 = k;
+  var desc = Object.getOwnPropertyDescriptor(m, k);
+  if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+    desc = {
+      enumerable: true,
+      get: function () {
+        return m[k];
+      }
+    };
+  }
+  Object.defineProperty(o, k2, desc);
+} : function (o, m, k, k2) {
+  if (k2 === undefined) k2 = k;
+  o[k2] = m[k];
+});
+var __setModuleDefault = this && this.__setModuleDefault || (Object.create ? function (o, v) {
+  Object.defineProperty(o, "default", {
+    enumerable: true,
+    value: v
+  });
+} : function (o, v) {
+  o["default"] = v;
+});
+var __importStar = this && this.__importStar || function (mod) {
+  if (mod && mod.__esModule) return mod;
+  var result = {};
+  if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+  __setModuleDefault(result, mod);
+  return result;
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.renderCliReference = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const commands = __importStar(require("../commands"));
+/**
+ * renders the CLI command reference of the catladder-cli agent skill
+ * from the command definitions, so the skill always documents the
+ * commands that actually exist. Runs as part of the cli build
+ * (`build:skill-cli-reference`) and writes into the repository's
+ * `skills/` directory — commit the result.
+ */
+const kebab = name => name.replace(/([A-Z])/g, "-$1").toLowerCase();
+const cleanMessage = message => message.replace(/\s*🤔\s*$/, "").trim();
+const renderInput = ([name, def]) => {
+  const description = cleanMessage(def.message);
+  const details = [def.required ? "required" : undefined, "default" in def && def.default !== undefined ? `default: ${JSON.stringify(def.default)}` : undefined].filter(Boolean).join(", ");
+  const usage = def.positional ? `\`${name}\` (positional)` : def.type === "boolean" ? `\`--${kebab(name)}\`` : `\`--${kebab(name)} <value>\``;
+  return `- ${usage}: ${description}${details ? ` (${details})` : ""}`;
+};
+const renderCommand = def => {
+  const positionals = Object.entries(def.inputs).filter(([, input]) => input.positional).map(([name]) => ` [${name}]`).join("");
+  const inputs = Object.entries(def.inputs);
+  return [`## \`catladder ${def.name}${positionals}\``, "", def.description, ...(inputs.length > 0 ? ["", ...inputs.map(renderInput)] : [])].join("\n");
+};
+const isCommandDef = value => typeof value === "object" && value !== null && "name" in value && "execute" in value;
+const renderCliReference = () => {
+  const defs = Object.values(commands).filter(isCommandDef).sort((a, b) => a.name.localeCompare(b.name));
+  return ["# catladder CLI command reference", "", "<!-- rendered from the command definitions by", "     cli/src/scripts/generateCliSkillReference.ts — do not edit -->", "", "All commands run non-interactively as `yarn catladder <command> ...`;", "see SKILL.md for how to pass inputs.", "", defs.map(renderCommand).join("\n\n"), ""].join("\n");
+};
+exports.renderCliReference = renderCliReference;
+// executed by the cli build via tsx (node itself cannot require the
+// ESM-only deps of the command modules on older versions)
+const main = () => {
+  const repoRootCandidates = [(0, path_1.join)(__dirname, "../../.."),
+  // source: cli/src/scripts
+  (0, path_1.join)(__dirname, "../../../../..") // compiled: cli/dist/cli/src/scripts
+  ];
+  const repoRoot = repoRootCandidates.find(candidate => (0, fs_1.existsSync)((0, path_1.join)(candidate, "skills")));
+  if (!repoRoot) {
+    throw new Error("skills directory not found next to the cli workspace");
+  }
+  const target = (0, path_1.join)(repoRoot, "skills", "catladder-cli", "references", "commands.md");
+  (0, fs_1.mkdirSync)((0, path_1.join)(target, ".."), {
+    recursive: true
+  });
+  (0, fs_1.writeFileSync)(target, (0, exports.renderCliReference)(), "utf-8");
+  console.log(`wrote ${target}`);
+};
+if (require.main === module) {
+  main();
+}

package/dist/cli/src/scripts/generateCliSkillReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateCliSkillReference.js","sourceRoot":"","sources":["../../../../src/scripts/generateCliSkillReference.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/src/agentSkills/generateAgentSkills.d.ts

@@ -0,0 +1,22 @@
+import type { CatenvContext } from "../catenv";
+/**
+ * marks a materialized skill file as generated. Cleanup only ever
+ * removes skill directories whose SKILL.md carries this marker, so a
+ * user's own skills are never touched — even if they picked a
+ * `catladder-*` name.
+ */
+export declare const AGENT_SKILL_GENERATED_MARKER = "<!-- \uD83D\uDC31 \uD83D\uDD28 generated by catladder \u2014 do not edit manually, this file is overwritten on every catenv run -->";
+/**
+ * inserts the generated-marker into a markdown file: after the YAML
+ * frontmatter when there is one (a leading comment would break
+ * frontmatter parsing), at the top otherwise
+ */
+export declare const injectGeneratedMarker: (content: string) => string;
+/**
+ * materializes the agent skills shipped with catladder (usage guides
+ * for AI coding agents) into the repository's agent skill directories,
+ * so agents working in the project use knowledge matching the installed
+ * catladder version. Opt out or narrow the targets via
+ * `agentSkills` in the config.
+ */
+export declare const generateAgentSkills: (context: CatenvContext, rootDir?: string) => Promise<void>;