@stonepandastudio/cairn 0.4.0 → 0.4.1

package/README.md

@@ -79,7 +79,9 @@ Credentials come from the repo's `.env` — `JIRA_BASE_URL` / `JIRA_USER` /
 `JIRA_PASSWORD` for `jira-server` (Basic auth: Jira Server 8.5.1 predates PATs), or
 `YOUTRACK_URL` / `YOUTRACK_TOKEN` / `YOUTRACK_PROJECT` for `youtrack` (Bearer token,
 admin-read scope for the project and stage-bundle lookups). Anything already in the
-environment wins over the file.
+environment wins over the file. If the repo's own app reads those same names, set
+`tracker.envPrefix` (`cairn init --env-prefix CAIRN_`) so cairn reads
+`CAIRN_YOUTRACK_TOKEN` instead — or point `tracker.env` at a separate file.
 
 ### Legacy command names
 
@@ -168,4 +170,4 @@ schema.json            JSON Schema for cairn.config.json
 test/run.js            dependency-free test runner
 ```
 
-No runtime dependencies. Node >= 18. `npm test` runs 51 tests.
+No runtime dependencies. Node >= 18. `npm test` runs 54 tests.

package/lib/config.js

@@ -84,6 +84,10 @@ function normalizeTracker(tracker) {
   t.issueTypes = { story: 'Story', subtask: 'Sub-task', ...(t.issueTypes || {}) };
   t.statuses = { todo: 'To Do', inProgress: 'In Progress', done: 'Done', ...(t.statuses || {}) };
   t.env = t.env || '.env';
+  // Prepended to every credential var name the provider reads — set it when the
+  // repo's app talks to the same tracker with its own credentials and `JIRA_*` /
+  // `YOUTRACK_*` would collide. Empty by default.
+  t.envPrefix = t.envPrefix || '';
   return t;
 }
 

package/lib/init.js

@@ -49,8 +49,10 @@ Usage: cairn init [options]
   --stack <names>          comma-separated, framework first: nestjs,typeorm | angular | cli
   --tracker <provider>     ${listProviders().join(' | ')}   (default: none)
   --project-key <KEY>      tracker project key, e.g. PROOF
-  --story-type <name>      parent issue type  (default: Story)
-  --subtask-type <name>    child issue type   (default: Sub-task)
+  --story-type <name>      parent issue type  (default: Story, jira-server only)
+  --subtask-type <name>    child issue type   (default: Sub-task, jira-server only)
+  --env-prefix <PFX>       prefix for the tracker credential vars, e.g. CAIRN_
+                           (only when the repo's app reads JIRA_*/YOUTRACK_* itself)
   --no-shim                do not vendor or replace the ai/scripts/*.js client shims
   --force                  overwrite an existing cairn.config.json
   --dry-run                print what would be written, write nothing
@@ -64,6 +66,7 @@ function parseArgs(argv) {
     projectKey: null,
     storyType: 'Story',
     subtaskType: 'Sub-task',
+    envPrefix: '',
     shim: true,
     force: false,
     dryRun: false,
@@ -77,6 +80,7 @@ function parseArgs(argv) {
     else if (a === '--project-key') args.projectKey = argv[++i];
     else if (a === '--story-type') args.storyType = argv[++i];
     else if (a === '--subtask-type') args.subtaskType = argv[++i];
+    else if (a === '--env-prefix') args.envPrefix = argv[++i];
     else if (a === '--no-shim') args.shim = false;
     else if (a === '--force') args.force = true;
     else if (a === '--dry-run') args.dryRun = true;
@@ -100,6 +104,7 @@ function buildConfig(args) {
   if (args.tracker !== 'none') {
     cfg.tracker.projectKey = args.projectKey;
     cfg.tracker.env = '.env';
+    if (args.envPrefix) cfg.tracker.envPrefix = args.envPrefix;
     // issueTypes is a Jira concept — YouTrack has no Task/Sub-task split.
     if (args.tracker === 'jira-server') {
       cfg.tracker.issueTypes = { story: args.storyType, subtask: args.subtaskType };
@@ -190,9 +195,8 @@ function main(argv = process.argv.slice(2)) {
     );
   }
   if (args.tracker !== 'none') {
-    console.log(
-      paint.dim(`\n  Next: ensure .env has JIRA_BASE_URL, JIRA_USER, JIRA_PASSWORD, then run`),
-    );
+    const envVars = require('./tracker').providerEnv(args.tracker, args.envPrefix);
+    console.log(paint.dim(`\n  Next: ensure .env has ${envVars.join(', ')}, then run`));
     console.log(paint.dim(`        npx cairn tracker list-statuses ${args.projectKey}`));
   }
   return 0;

package/lib/tracker/index.js

@@ -1,8 +1,10 @@
 'use strict';
 
 const { loadEnv, loadRepoConfig, findRepoRoot, ConfigError } = require('../config');
-const { createJiraServer, TrackerError, NoTransitionError } = require('./jira-server');
-const { createYouTrack } = require('./youtrack');
+const jiraServer = require('./jira-server');
+const youtrack = require('./youtrack');
+const { createJiraServer, TrackerError, NoTransitionError } = jiraServer;
+const { createYouTrack } = youtrack;
 const { createNone } = require('./none');
 
 // Provider registry. Adding Linear or GitHub Issues later means adding one entry
@@ -18,6 +20,18 @@ function listProviders() {
   return Object.keys(PROVIDERS);
 }
 
+// The .env variables a provider reads. `cairn init` prints these as the next step,
+// so a youtrack repo is not told to set JIRA_* and vice versa.
+const CREDENTIAL_ENV = {
+  'jira-server': jiraServer.CREDENTIAL_ENV,
+  youtrack: youtrack.CREDENTIAL_ENV,
+  none: [],
+};
+
+function providerEnv(name, prefix = '') {
+  return (CREDENTIAL_ENV[name] || []).map((v) => prefix + v);
+}
+
 // Build a tracker straight from a tracker config block plus an env bag.
 function createTracker(trackerConfig = {}, env = process.env) {
   const name = trackerConfig.provider || 'none';
@@ -48,6 +62,7 @@ module.exports = {
   createTracker,
   trackerForRepo,
   listProviders,
+  providerEnv,
   TrackerError,
   NoTransitionError,
 };

package/lib/tracker/jira-server.js

@@ -38,14 +38,15 @@ class NoTransitionError extends TrackerError {
 const REQUIRED_ENV = ['JIRA_BASE_URL', 'JIRA_USER', 'JIRA_PASSWORD'];
 
 function createJiraServer(config = {}, env = process.env) {
-  const baseUrl = (config.baseUrl || env.JIRA_BASE_URL || '').replace(/\/+$/, '');
-  const user = config.user || env.JIRA_USER;
-  const password = config.password || env.JIRA_PASSWORD;
+  const pfx = config.envPrefix || '';
+  const baseUrl = (config.baseUrl || env[pfx + 'JIRA_BASE_URL'] || '').replace(/\/+$/, '');
+  const user = config.user || env[pfx + 'JIRA_USER'];
+  const password = config.password || env[pfx + 'JIRA_PASSWORD'];
   const projectKey = config.projectKey;
   const issueTypes = { story: 'Story', subtask: 'Sub-task', ...(config.issueTypes || {}) };
 
   function assertConfig() {
-    const missing = REQUIRED_ENV.filter((k, i) => ![baseUrl, user, password][i]);
+    const missing = REQUIRED_ENV.filter((k, i) => ![baseUrl, user, password][i]).map((k) => pfx + k);
     if (missing.length) {
       throw new TrackerError(
         `Missing Jira credentials: ${missing.join(', ')}. Set them in the repo's .env or the environment.`,
@@ -322,4 +323,4 @@ function createJiraServer(config = {}, env = process.env) {
   };
 }
 
-module.exports = { createJiraServer, TrackerError, NoTransitionError };
+module.exports = { createJiraServer, TrackerError, NoTransitionError, CREDENTIAL_ENV: REQUIRED_ENV };

package/lib/tracker/youtrack.js

@@ -21,16 +21,20 @@
 const { TrackerError, NoTransitionError } = require('./jira-server');
 
 const REQUIRED_ENV = ['YOUTRACK_URL', 'YOUTRACK_TOKEN'];
+// What `cairn init` tells the user to put in .env — includes the project, which
+// the guard treats as optional only because it can also come from cairn.config.json.
+const CREDENTIAL_ENV = ['YOUTRACK_URL', 'YOUTRACK_TOKEN', 'YOUTRACK_PROJECT'];
 const STAGE_FIELD = 'Stage';
 const ASSIGNEE_FIELD = 'Assignee';
 
 function createYouTrack(config = {}, env = process.env) {
-  const baseUrl = (config.baseUrl || env.YOUTRACK_URL || '').replace(/\/+$/, '');
-  const token = config.token || env.YOUTRACK_TOKEN;
-  const projectKey = config.projectKey || env.YOUTRACK_PROJECT;
+  const pfx = config.envPrefix || '';
+  const baseUrl = (config.baseUrl || env[pfx + 'YOUTRACK_URL'] || '').replace(/\/+$/, '');
+  const token = config.token || env[pfx + 'YOUTRACK_TOKEN'];
+  const projectKey = config.projectKey || env[pfx + 'YOUTRACK_PROJECT'];
 
   function assertConfig() {
-    const missing = REQUIRED_ENV.filter((k, i) => ![baseUrl, token][i]);
+    const missing = REQUIRED_ENV.filter((k, i) => ![baseUrl, token][i]).map((k) => pfx + k);
     if (missing.length) {
       throw new TrackerError(
         `Missing YouTrack credentials: ${missing.join(', ')}. Set them in the repo's .env or the environment.`,
@@ -314,4 +318,4 @@ function createYouTrack(config = {}, env = process.env) {
   };
 }
 
-module.exports = { createYouTrack, TrackerError, NoTransitionError };
+module.exports = { createYouTrack, TrackerError, NoTransitionError, CREDENTIAL_ENV };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonepandastudio/cairn",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Shared AI workflow scaffolding for Stone Panda repos — issue tracker client and drift doctor.",
   "license": "UNLICENSED",
   "repository": {

package/schema.json

@@ -51,6 +51,12 @@
           "type": "string",
           "default": ".env",
           "description": "Path, relative to the repo root, of the file holding tracker credentials."
+        },
+        "envPrefix": {
+          "type": "string",
+          "default": "",
+          "description": "Prepended to every credential var the provider reads (e.g. \"CAIRN_\" → CAIRN_YOUTRACK_TOKEN). Set it only when the repo's own app reads JIRA_*/YOUTRACK_* and the names would collide.",
+          "examples": ["CAIRN_"]
         }
       }
     },