@ritualai/cli 0.7.15 → 0.8.0

package/dist/lib/persona-samples.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * Static lookup table: persona slug → presentation data for the
+ * onboarding screens.
+ *
+ * Each entry carries the data the CLI needs to render the persona
+ * picker, the workspace-explainer card, and the build-flow handover
+ * box without a network call. Two pieces of justification:
+ *
+ *   1. The persona-pick step happens at `ritual init` time, before
+ *      the workspace exists and before the user has approved any
+ *      API calls. We want the picker to feel instant — no spinner
+ *      while we hit `/templates`.
+ *
+ *   2. The discipline framing + sample exploration names are
+ *      curation, not data the API has today. Keeping the curation
+ *      CLI-side is fine: the underlying template (id matches the
+ *      `slug` here) is what gets used downstream; this file is
+ *      presentation polish.
+ *
+ * When a new Engineering template ships in
+ * `apps/api/scripts/templates/`, add a matching entry here. Persona
+ * slug MUST equal the template's `schema.id` (the JSON file's `id`
+ * field) — that's how `/ritual build` looks up the right default
+ * template at build time.
+ *
+ * Maintenance shape: this is ~12 entries × ~10 fields = a couple
+ * hundred lines, churns only when the Engineering template family
+ * grows. The seed pipeline doesn't read this file; this is
+ * CLI-render-time data only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURED_PERSONA_SLUGS = exports.GENERIC_PERSONA = exports.PERSONA_SAMPLES = void 0;
+exports.findPersona = findPersona;
+const colors_1 = require("./colors");
+// Accents chosen to be visually distinct under 16-color and 256-color
+// terminals as well as truecolor. Keep each persona in a different
+// hue family so adjacent cards in the picker don't blend.
+const ACCENT = {
+    teal: colors_1.RITUAL_TEAL,
+    blue: [0x4f, 0x9a, 0xff],
+    violet: [0x9b, 0x6f, 0xff],
+    magenta: [0xd8, 0x5f, 0xc0],
+    red: [0xe0, 0x5f, 0x5f],
+    amber: [0xe0, 0xa8, 0x4f],
+    green: [0x60, 0xc7, 0x70],
+    cyan: [0x5f, 0xc7, 0xc7],
+};
+exports.PERSONA_SAMPLES = [
+    {
+        slug: 'backend-services',
+        label: 'Backend Services',
+        shortLabel: 'Backend',
+        framing: 'backend services — APIs, workers, contracts, persistence',
+        sampleExplorations: [
+            'Add rate limit to /orders',
+            'Make Idempotency-Key required for POSTs',
+            'Split monolithic /search into focused services',
+        ],
+        accent: ACCENT.teal,
+        caresAbout: ['APIs', 'workers', 'transactions', 'idempotency', 'tracing'],
+    },
+    {
+        slug: 'frontend-web',
+        label: 'Frontend Web',
+        shortLabel: 'Frontend',
+        framing: 'frontend web — components, state, perf, accessibility',
+        sampleExplorations: [
+            'Improve checkout LCP',
+            'Add empty state to settings page',
+            'Fix keyboard nav on /admin tabs',
+        ],
+        accent: ACCENT.cyan,
+        caresAbout: ['components', 'state', 'routing', 'a11y', 'RUM', 'bundle'],
+    },
+    {
+        slug: 'data-engineering',
+        label: 'Data Engineering',
+        shortLabel: 'Data',
+        framing: 'data engineering — pipelines, schemas, lineage, SLAs',
+        sampleExplorations: [
+            'Add CDC for orders → fact_revenue',
+            'Handle late-arriving events in user_sessions',
+            'Deprecate fact_v1; cut consumers to fact_v2',
+        ],
+        accent: ACCENT.blue,
+        caresAbout: ['ETL/ELT', 'schemas', 'lineage', 'freshness', 'backfills'],
+    },
+    {
+        slug: 'ml-engineering',
+        label: 'ML Engineering',
+        shortLabel: 'ML',
+        framing: 'ML engineering — datasets, training, eval, serving, drift',
+        sampleExplorations: [
+            'Experiment: new ranking model v4 vs v3',
+            'Add online drift detection for recs',
+            'Retraining cadence for fraud classifier',
+        ],
+        accent: ACCENT.violet,
+        caresAbout: ['datasets', 'features', 'evals', 'serving', 'drift'],
+    },
+    {
+        slug: 'platform-engineering',
+        label: 'Platform Engineering',
+        shortLabel: 'Platform',
+        framing: 'platform — IaC, CI/CD, SLOs, observability, on-call',
+        sampleExplorations: [
+            'Set up SLO for /api endpoints (99.9%)',
+            'Add per-tenant rate limiting',
+            'Ephemeral preview env per PR',
+        ],
+        accent: ACCENT.green,
+        caresAbout: ['IaC', 'CI/CD', 'SLOs', 'rollouts', 'observability'],
+    },
+    {
+        slug: 'security-engineering',
+        label: 'Security Engineering',
+        shortLabel: 'Security',
+        framing: 'security — threat models, controls, audit, supply chain',
+        sampleExplorations: [
+            'Threat model for /webhooks endpoint',
+            'Audit log retention for compliance',
+            'Rotate JWT signing keys quarterly',
+        ],
+        accent: ACCENT.red,
+        caresAbout: ['threats', 'authN/Z', 'secrets', 'SAST/DAST', 'audit'],
+    },
+    {
+        slug: 'developer-tooling',
+        label: 'Developer Tooling',
+        shortLabel: 'DevTools',
+        framing: 'developer tooling — CLIs, MCPs, structured I/O, distribution',
+        sampleExplorations: [
+            'Add --json output to ritual init',
+            'MCP tool: generate eval report',
+            'Skill: lint imports in PR diffs',
+        ],
+        accent: ACCENT.amber,
+        caresAbout: ['CLI UX', 'exit codes', 'JSON output', 'versioning', 'DX'],
+    },
+    {
+        slug: 'embedded-firmware',
+        label: 'Embedded / Firmware',
+        shortLabel: 'Embedded',
+        framing: 'embedded — MCU, RTOS, memory, peripherals, boot, OTA',
+        sampleExplorations: [
+            'OTA rollback safety check',
+            'Watchdog timeout for sensor task',
+            'Power budget for BLE advertising',
+        ],
+        accent: ACCENT.green,
+        caresAbout: ['MCU', 'RTOS', 'memory', 'peripherals', 'OTA', 'power'],
+    },
+    {
+        slug: 'game-development',
+        label: 'Game Development',
+        shortLabel: 'Game Dev',
+        framing: 'game dev — engines, scenes, frame budget, assets',
+        sampleExplorations: [
+            'Weapon-charging mechanic in L1',
+            'Asset streaming for level 3',
+            'Frame budget for new VFX system',
+        ],
+        accent: ACCENT.magenta,
+        caresAbout: ['engine', 'scenes', 'FPS', 'shaders', 'assets'],
+    },
+    {
+        slug: 'smart-contracts',
+        label: 'Smart Contracts',
+        shortLabel: 'Contracts',
+        framing: 'smart contracts — on-chain, gas, invariants, audits',
+        sampleExplorations: [
+            'Upgrade authority multisig (4-of-7)',
+            'Gas optimization for batch deposits',
+            'Invariant: totalSupply == sum(balances)',
+        ],
+        accent: ACCENT.amber,
+        caresAbout: ['state', 'gas', 'invariants', 'oracles', 'audits'],
+    },
+    {
+        slug: 'desktop-apps',
+        label: 'Desktop Apps',
+        shortLabel: 'Desktop',
+        framing: 'desktop apps — OS APIs, installers, signing, auto-update',
+        sampleExplorations: [
+            'Auto-update rollback on first-launch crash',
+            'macOS notarization in CI',
+            'Menu bar app + Windows tray parity',
+        ],
+        accent: ACCENT.cyan,
+        caresAbout: ['OS APIs', 'installers', 'signing', 'updates', 'crashes'],
+    },
+    {
+        slug: 'qa-engineering',
+        label: 'QA Engineering',
+        shortLabel: 'QA',
+        framing: 'QA — test strategy, harness, flake mgmt, release gates',
+        sampleExplorations: [
+            'Contract tests between web ↔ api',
+            'Flake quarantine policy + SLA',
+            'Release-blocking gate definition',
+        ],
+        accent: ACCENT.blue,
+        caresAbout: ['test pyramid', 'harnesses', 'flakes', 'contracts', 'CI cost'],
+    },
+];
+/** Look up a persona by slug. Returns null for unknown slugs. */
+function findPersona(slug) {
+    if (!slug)
+        return null;
+    return exports.PERSONA_SAMPLES.find((p) => p.slug === slug) ?? null;
+}
+/**
+ * Generic fallback persona used when the user has skipped the picker
+ * (e.g. `--persona none` or non-TTY automation). Lets the workspace
+ * explainer + build-flow explainer still render with sensible
+ * defaults instead of crashing on null.
+ */
+exports.GENERIC_PERSONA = {
+    slug: 'backend-services', // safe default; never persisted unless picked
+    label: 'Software Engineer',
+    shortLabel: 'Engineer',
+    framing: 'software — features, refactors, investigations',
+    sampleExplorations: [
+        'New feature from a brief',
+        'Refactor existing code',
+        'Investigation before coding',
+    ],
+    accent: colors_1.RITUAL_TEAL,
+    caresAbout: ['features', 'tests', 'rollout', 'review'],
+};
+/**
+ * The 5 personas surfaced first in the picker — by rough community
+ * frequency. The rest are revealed via "see more." Order tuned for
+ * the most common backend/frontend/data starting points, with
+ * platform + ML following.
+ */
+exports.FEATURED_PERSONA_SLUGS = [
+    'backend-services',
+    'frontend-web',
+    'data-engineering',
+    'ml-engineering',
+    'platform-engineering',
+];
+//# sourceMappingURL=persona-samples.js.map

package/dist/lib/persona-samples.js.map

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

package/dist/lib/project-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/lib/project-config.ts"],"names":[],"mappings":";;AA8CA,oDAEC;AAOD,8CAeC;AAUD,8CAIC;AApFD,qCAA6E;AAC7E,yCAA0C;AA0C1C,MAAM,sBAAsB,GAAG,SAAS,CAAC;AACzC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAE9C,SAAgB,oBAAoB,CAAC,UAAkB;IACtD,OAAO,IAAA,gBAAI,EAAC,UAAU,EAAE,sBAAsB,EAAE,uBAAuB,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,UAAkB;IACnD,MAAM,CAAC,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAA,oBAAU,EAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,IAAA,sBAAY,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAChD,8DAA8D;QAC9D,gEAAgE;QAChE,8BAA8B;QAC9B,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC/E,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,UAAkB,EAAE,MAAqB;IAC1E,MAAM,CAAC,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAA,mBAAS,EAAC,IAAA,mBAAO,EAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,IAAA,uBAAa,EAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/lib/project-config.ts"],"names":[],"mappings":";;AA8DA,oDAEC;AAOD,8CAeC;AAUD,8CAIC;AApGD,qCAA6E;AAC7E,yCAA0C;AA0D1C,MAAM,sBAAsB,GAAG,SAAS,CAAC;AACzC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAE9C,SAAgB,oBAAoB,CAAC,UAAkB;IACtD,OAAO,IAAA,gBAAI,EAAC,UAAU,EAAE,sBAAsB,EAAE,uBAAuB,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,UAAkB;IACnD,MAAM,CAAC,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAA,oBAAU,EAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,IAAA,sBAAY,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAChD,8DAA8D;QAC9D,gEAAgE;QAChE,8BAA8B;QAC9B,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC/E,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,UAAkB,EAAE,MAAqB;IAC1E,MAAM,CAAC,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAA,mBAAS,EAAC,IAAA,mBAAO,EAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,IAAA,uBAAa,EAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACnE,CAAC"}

package/dist/lib/skill-bundles.js

@@ -20,6 +20,10 @@ const skill_manifest_1 = require("./skill-manifest");
 function findLocalSkillBundles(projectDir, cliVersion) {
     const found = [];
     for (const provider of providers_1.PROVIDERS) {
+        // MCP-only agents (no projectSkillDir, e.g. Windsurf as of 0.7.16)
+        // have nothing on disk to walk — skip silently.
+        if (!provider.projectSkillDir)
+            continue;
         const skillRoot = (0, node_path_1.join)(projectDir, provider.projectSkillDir);
         if (!(0, node_fs_1.existsSync)(skillRoot))
             continue;

package/dist/lib/skill-bundles.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-bundles.js","sourceRoot":"","sources":["../../src/lib/skill-bundles.ts"],"names":[],"mappings":";;AAqCA,sDAgCC;AAQD,4CAEC;AA/ED,qCAA4D;AAC5D,yCAAiC;AACjC,kDAAmE;AACnE,qDAA4F;AAuB5F;;;;;;;;;;GAUG;AACH,SAAgB,qBAAqB,CAAC,UAAkB,EAAE,UAAkB;IAC3E,MAAM,KAAK,GAAuB,EAAE,CAAC;IAErC,KAAK,MAAM,QAAQ,IAAI,qBAAS,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAA,oBAAU,EAAC,SAAS,CAAC;YAAE,SAAS;QAErC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACJ,OAAO,GAAG,IAAA,qBAAW,EAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;iBACvD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACxC,6DAA6D;YAC7D,2BAA2B;YAC3B,IAAI,CAAC;gBACJ,IAAI,CAAC,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAC,WAAW,EAAE;oBAAE,SAAS;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACR,SAAS;YACV,CAAC;YACD,MAAM,QAAQ,GAAG,IAAA,kCAAiB,EAAC,IAAI,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,IAAA,oCAAmB,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,OAA2B;IAC3D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AACtF,CAAC"}
+{"version":3,"file":"skill-bundles.js","sourceRoot":"","sources":["../../src/lib/skill-bundles.ts"],"names":[],"mappings":";;AAqCA,sDAmCC;AAQD,4CAEC;AAlFD,qCAA4D;AAC5D,yCAAiC;AACjC,kDAAmE;AACnE,qDAA4F;AAuB5F;;;;;;;;;;GAUG;AACH,SAAgB,qBAAqB,CAAC,UAAkB,EAAE,UAAkB;IAC3E,MAAM,KAAK,GAAuB,EAAE,CAAC;IAErC,KAAK,MAAM,QAAQ,IAAI,qBAAS,EAAE,CAAC;QAClC,mEAAmE;QACnE,gDAAgD;QAChD,IAAI,CAAC,QAAQ,CAAC,eAAe;YAAE,SAAS;QACxC,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAA,oBAAU,EAAC,SAAS,CAAC;YAAE,SAAS;QAErC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACJ,OAAO,GAAG,IAAA,qBAAW,EAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;iBACvD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACxC,6DAA6D;YAC7D,2BAA2B;YAC3B,IAAI,CAAC;gBACJ,IAAI,CAAC,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAC,WAAW,EAAE;oBAAE,SAAS;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACR,SAAS;YACV,CAAC;YACD,MAAM,QAAQ,GAAG,IAAA,kCAAiB,EAAC,IAAI,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,IAAA,oCAAmB,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,OAA2B;IAC3D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AACtF,CAAC"}

package/dist/lib/skill-copy.js

@@ -18,18 +18,31 @@ function getPackageRoot() {
     return (0, node_path_1.resolve)(__dirname, '..', '..');
 }
 /**
- * Copy every skill bundled for `provider` into the project.
+ * Copy every skill bundled for `provider` into the user's project
+ * AND (when supported) into the user-global skills dir.
  *
  * `projectDir` is usually `process.cwd()` but parameterized so tests
  * can write to a temp directory.
  */
 function copySkillsForProvider(provider, projectDir, packageRoot = getPackageRoot()) {
+    // MCP-only agents (currently Windsurf) have no skill destinations.
+    // Return an empty result so the caller treats them as "scaffolded
+    // nothing" without erroring.
+    if (!provider.projectSkillDir || !provider.packageSkillDir) {
+        return {
+            provider,
+            copied: 0,
+            reason: 'agent has no skill-install convention (MCP-only)',
+            scopes: [],
+        };
+    }
     const sourceBase = (0, node_path_1.join)(packageRoot, provider.packageSkillDir);
     if (!(0, node_fs_1.existsSync)(sourceBase)) {
         return {
             provider,
             copied: 0,
             reason: `package missing ${provider.packageSkillDir}/ — try reinstalling @ritualai/cli`,
+            scopes: [],
         };
     }
     const skillDirs = (0, node_fs_1.readdirSync)(sourceBase, { withFileTypes: true })
@@ -40,18 +53,57 @@ function copySkillsForProvider(provider, projectDir, packageRoot = getPackageRoo
             provider,
             copied: 0,
             reason: 'no skills found in package bundle',
+            scopes: [],
         };
     }
-    const targetBase = (0, node_path_1.join)(projectDir, provider.projectSkillDir);
-    for (const name of skillDirs) {
+    // Project-local copy: always attempted.
+    const projectResult = copyAllToDestination('project', (0, node_path_1.join)(projectDir, provider.projectSkillDir), sourceBase, skillDirs);
+    // User-global copy: only when the provider declares a userSkillDir.
+    // Agents like Cursor (settings-DB-only) and Windsurf (MCP-only)
+    // omit this; doctor surfaces the asymmetry for users who care.
+    const scopes = [projectResult];
+    if (provider.userSkillDir) {
+        scopes.push(copyAllToDestination('user-global', provider.userSkillDir, sourceBase, skillDirs));
+    }
+    const totalCopied = scopes.reduce((sum, s) => sum + s.copied, 0);
+    const failures = scopes.filter((s) => s.reason).map((s) => `${s.scope}: ${s.reason}`);
+    return {
+        provider,
+        copied: totalCopied,
+        reason: failures.length > 0 ? failures.join('; ') : undefined,
+        scopes,
+    };
+}
+/**
+ * Copy every `skillName` from `sourceBase/<name>/` to
+ * `destinationBase/<name>/`. Returns a CopyScopeResult — success
+ * counts skills that landed, failures populate `reason`. Permission /
+ * filesystem errors are caught so a single bad agent doesn't abort
+ * the whole `ritual init` run.
+ */
+function copyAllToDestination(scope, destinationBase, sourceBase, skillNames) {
+    let copied = 0;
+    let lastError;
+    for (const name of skillNames) {
         const src = (0, node_path_1.join)(sourceBase, name);
-        const dest = (0, node_path_1.join)(targetBase, name);
-        (0, node_fs_1.mkdirSync)(dest, { recursive: true });
-        // `force: true` overwrites; `recursive: true` walks the whole
-        // skill directory (covers SKILL.md + any sibling assets like
-        // nested examples/ or templates/).
-        (0, node_fs_1.cpSync)(src, dest, { recursive: true, force: true });
+        const dest = (0, node_path_1.join)(destinationBase, name);
+        try {
+            (0, node_fs_1.mkdirSync)(dest, { recursive: true });
+            // `force: true` overwrites; `recursive: true` walks the whole
+            // skill directory (covers SKILL.md + any sibling assets like
+            // nested examples/ or templates/).
+            (0, node_fs_1.cpSync)(src, dest, { recursive: true, force: true });
+            copied++;
+        }
+        catch (err) {
+            lastError = `${name}: ${err.message}`;
+        }
     }
-    return { provider, copied: skillDirs.length };
+    return {
+        scope,
+        destination: destinationBase,
+        copied,
+        reason: copied < skillNames.length ? lastError ?? 'partial copy' : undefined,
+    };
 }
 //# sourceMappingURL=skill-copy.js.map

package/dist/lib/skill-copy.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-copy.js","sourceRoot":"","sources":["../../src/lib/skill-copy.ts"],"names":[],"mappings":";;AA0CA,wCAEC;AAQD,sDAwCC;AA5FD,qCAAqE;AACrE,yCAA0C;AA+B1C;;;;;;;;;GASG;AACH,SAAgB,cAAc;IAC7B,OAAO,IAAA,mBAAO,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CACpC,QAAuB,EACvB,UAAkB,EAClB,cAAsB,cAAc,EAAE;IAEtC,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,WAAW,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAE/D,IAAI,CAAC,IAAA,oBAAU,EAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,OAAO;YACN,QAAQ;YACR,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,mBAAmB,QAAQ,CAAC,eAAe,oCAAoC;SACvF,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAA,qBAAW,EAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAChE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAErB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACN,QAAQ;YACR,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,mCAAmC;SAC3C,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAE9D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACpC,IAAA,mBAAS,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,8DAA8D;QAC9D,6DAA6D;QAC7D,mCAAmC;QACnC,IAAA,gBAAM,EAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"skill-copy.js","sourceRoot":"","sources":["../../src/lib/skill-copy.ts"],"names":[],"mappings":"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"}

package/dist/lib/workspace-explainer.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Workspace explainer — onboarding screen #2 of 3.
+ *
+ * Shown once per machine on first `ritual init` (gated by
+ * onboarding-state.ts). Teaches the user the mental model:
+ *
+ *   - Workspace = container for explorations on this codebase
+ *   - Explorations = boxes of work (problem → answers → recs → brief → impl)
+ *   - Context flows between explorations within a workspace
+ *     (decisions, anti-goals, file lineage carry forward)
+ *
+ * Personalized via:
+ *   - Workspace name (git-remote-detected, falls back to cwd basename)
+ *   - Persona slug (when set) → discipline framing + 3 sample
+ *     exploration names from persona-samples.ts
+ *
+ * Non-TTY fallback: terse 3-line summary printed via printTerse().
+ * Caller is expected to check tty + onboarding state before calling
+ * the rich version.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectColorMode = void 0;
+exports.printWorkspaceExplainer = printWorkspaceExplainer;
+exports.printWorkspaceExplainerTerse = printWorkspaceExplainerTerse;
+const colors_1 = require("./colors");
+Object.defineProperty(exports, "detectColorMode", { enumerable: true, get: function () { return colors_1.detectColorMode; } });
+const persona_samples_1 = require("./persona-samples");
+/** Width target. Matches welcome-banner.ts for visual consistency. */
+const BOX_WIDTH = 78;
+/**
+ * Render the workspace explainer to stdout. Always renders (caller
+ * decides whether to skip based on TTY + onboarding-state).
+ *
+ * The rich version assumes ≥80-char terminal width. For narrower
+ * terminals, callers should prefer printTerse().
+ */
+function printWorkspaceExplainer(opts) {
+    const persona = (0, persona_samples_1.findPersona)(opts.personaSlug) ?? persona_samples_1.GENERIC_PERSONA;
+    const accent = persona.accent;
+    const lines = [];
+    // Title bar carries the workspace name + brand-teal accent. The
+    // body BELOW it actually teaches what a workspace IS (replaces an
+    // earlier draft that just labeled "workspace: foo / you build: bar"
+    // without explaining the concept — the visual cards alone weren't
+    // enough to land it).
+    lines.push(box.top(BOX_WIDTH, (0, colors_1.color)(accent, `─ workspace: "${opts.workspaceName}" `)));
+    lines.push(box.padded(BOX_WIDTH, ''));
+    // Value-prop framing — mirrors the developer landing page at
+    // ritual.work/product/developer ("structured discovery, living
+    // specs, plans with less guesswork — so AI agents land changes
+    // you'd actually merge"). One bold opener + two dim continuation
+    // lines so the eye lands on the verb-noun phrases without the
+    // outcome clause getting lost in the wrap.
+    lines.push(box.padded(BOX_WIDTH, `  ${(0, colors_1.boldColor)(accent, 'where structured discovery, living specs, and plans with')}`));
+    lines.push(box.padded(BOX_WIDTH, `  ${(0, colors_1.boldColor)(accent, 'less guesswork come together —')}`));
+    lines.push(box.padded(BOX_WIDTH, `  ${(0, colors_1.dim)('so AI agents land changes you\'d actually merge.')}`));
+    lines.push(box.padded(BOX_WIDTH, ''));
+    // Inner container with 3 exploration cards side-by-side
+    lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.dim)('┌' + '─'.repeat(BOX_WIDTH - 8) + '┐')));
+    lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.dim)('│') + ' '.repeat(BOX_WIDTH - 8) + (0, colors_1.dim)('│')));
+    const cards = renderExplorationCardsRow(persona);
+    for (const cardLine of cards) {
+        lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.dim)('│ ') + cardLine + (0, colors_1.dim)(' │')));
+    }
+    // Down-arrows pointing to shared context
+    const arrowsLine = '       ↓               ↓               ↓';
+    lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.dim)('│   ') + (0, colors_1.dim)(arrowsLine.padEnd(BOX_WIDTH - 16)) + (0, colors_1.dim)('│')));
+    // Shared context strip
+    const contextLines = [
+        '  ┌─ shared context · knowledge graph ' + '─'.repeat(28) + '┐',
+        '  │ • decisions in one carry to the next' + ' '.repeat(28) + '│',
+        '  │ • anti-goals propagate forward' + ' '.repeat(34) + '│',
+        '  │ • file lineage: which exploration shaped this' + ' '.repeat(19) + '│',
+        '  │ • prior implementations inform new explorations' + ' '.repeat(17) + '│',
+        '  └' + '─'.repeat(65) + '┘',
+    ];
+    for (const cl of contextLines) {
+        lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.dim)('│ ') + (0, colors_1.color)(accent, cl) + (0, colors_1.dim)(' │')));
+    }
+    lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.dim)('│') + ' '.repeat(BOX_WIDTH - 8) + (0, colors_1.dim)('│')));
+    lines.push(box.padded(BOX_WIDTH, '  ' + (0, colors_1.dim)('└' + '─'.repeat(BOX_WIDTH - 8) + '┘')));
+    lines.push(box.padded(BOX_WIDTH, ''));
+    // What you'll do here. Kept short: only commands that exist + are
+    // expected to be the first thing the user reaches for. `/ritual
+    // lineage` lived here in the first draft; pulled because it's not
+    // shipping in the same window as this onboarding flow and we
+    // don't want to teach a command that doesn't work yet.
+    lines.push(box.padded(BOX_WIDTH, `  ${(0, colors_1.boldColor)(accent, 'what you\'ll do here:')}`));
+    lines.push(box.padded(BOX_WIDTH, `    ${(0, colors_1.dim)('›')} /ritual build <feature>   ${(0, colors_1.dim)('create an exploration')}`));
+    lines.push(box.padded(BOX_WIDTH, `    ${(0, colors_1.dim)('›')} /ritual resume            ${(0, colors_1.dim)('pick up where you left off')}`));
+    lines.push(box.padded(BOX_WIDTH, ''));
+    lines.push(box.bottom(BOX_WIDTH));
+    for (const line of lines) {
+        process.stdout.write(line + '\n');
+    }
+}
+/**
+ * Terse single-line-per-concept fallback for non-TTY or narrow
+ * terminals. No colors, no boxes — just the teaching.
+ */
+function printWorkspaceExplainerTerse(opts) {
+    // `persona` is intentionally not consulted in the terse path —
+    // the framing line was pulled in favor of an actual definition.
+    // Persona-specific examples still surface in the rich version.
+    void (0, persona_samples_1.findPersona)(opts.personaSlug);
+    process.stdout.write(`\n  workspace: "${opts.workspaceName}"\n`);
+    process.stdout.write('\n');
+    process.stdout.write('  Where structured discovery, living specs, and plans with less\n');
+    process.stdout.write('  guesswork come together — so AI agents land changes you\'d\n');
+    process.stdout.write('  actually merge.\n');
+    process.stdout.write('\n');
+    process.stdout.write('  Use /ritual build <feature> to create an exploration. /ritual resume\n');
+    process.stdout.write('  to pick up where you left off.\n');
+    process.stdout.write('\n');
+}
+// ─── helpers ────────────────────────────────────────────────────────────────
+/**
+ * Render the 3 exploration cards as a single 4-line column-block:
+ * top border with the "exploration" label, two title lines (most
+ * titles wrap to 2; short ones get a blank second line), bottom
+ * border. Lifecycle bullets used to live here; they were dropped
+ * because they teach the SAME thing as the build-flow explainer's
+ * phase chain (which is the right place for that detail). The
+ * workspace explainer should only convey the unit + that multiple
+ * units coexist in a workspace.
+ *
+ * Each card is 18 visible chars wide (`┌─ exploration ──┐`); 3 cards
+ * + 2 separators (2 spaces each) = 18*3 + 4 = 58 chars, well within
+ * the BOX_WIDTH - 8 = 70 inner budget.
+ */
+function renderExplorationCardsRow(persona) {
+    const titles = persona.sampleExplorations;
+    // Card body width (inside the side `│ … │` chars). Matches the
+    // width of the top/bottom borders so all three rows align cleanly.
+    const bodyW = 14;
+    // Wrap each title to 2 lines; pad the second line with empty so
+    // short titles still occupy the full card height.
+    const wrap = (s) => {
+        if (s.length <= bodyW)
+            return [s, ''];
+        const cut = s.slice(0, bodyW).lastIndexOf(' ');
+        if (cut <= 0)
+            return [s.slice(0, bodyW), s.slice(bodyW, 2 * bodyW)];
+        return [s.slice(0, cut), s.slice(cut + 1, cut + 1 + bodyW)];
+    };
+    const wrapped = titles.map(wrap);
+    const pad = (s) => s.padEnd(bodyW, ' ');
+    const top = '┌─ exploration ──┐';
+    const mid = '│';
+    const bot = '└────────────────┘';
+    const lines = [];
+    // Top border × 3
+    lines.push([top, top, top].join('  '));
+    // Title line 1 × 3
+    lines.push([wrapped[0][0], wrapped[1][0], wrapped[2][0]]
+        .map((t) => `${mid} ${pad(t)} ${mid}`)
+        .join('  '));
+    // Title line 2 × 3 (blank for short titles)
+    lines.push([wrapped[0][1], wrapped[1][1], wrapped[2][1]]
+        .map((t) => `${mid} ${pad(t)} ${mid}`)
+        .join('  '));
+    // Bottom border × 3
+    lines.push([bot, bot, bot].join('  '));
+    return lines;
+}
+/**
+ * Minimal box-drawing helpers. Local to this module to keep the
+ * file self-contained; if the workspace + build-flow explainers
+ * grow more shared box logic we can factor into a `box.ts`.
+ */
+const box = {
+    top(width, title) {
+        // Title sits at column 2, padded with ─ to fill width.
+        const stripped = stripAnsi(title);
+        const fillWidth = width - stripped.length - 4;
+        return `╭ ${title} ${'─'.repeat(Math.max(0, fillWidth))}╮`;
+    },
+    bottom(width) {
+        return '╰' + '─'.repeat(width - 2) + '╯';
+    },
+    padded(width, content) {
+        const stripped = stripAnsi(content);
+        const pad = ' '.repeat(Math.max(0, width - 2 - stripped.length));
+        return `│${content}${pad}│`;
+    },
+};
+/** Strip ANSI escape sequences so padding math is correct. */
+function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*m/g, '');
+}
+//# sourceMappingURL=workspace-explainer.js.map

package/dist/lib/workspace-explainer.js.map

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

package/dist/lib/workspace-flow.js

@@ -21,13 +21,14 @@ async function resolveProjectWorkspace(opts) {
         return null;
     }
     const detection = (0, repo_name_1.detectRepoName)(opts.projectDir);
-    console.log('');
-    console.log('  No Ritual workspace is bound to this project yet.');
-    console.log('');
-    console.log('  A workspace is this project\'s persistent memory in Ritual — explorations,');
-    console.log('  decisions, build briefs, and context agents can reuse across sessions.');
-    console.log('');
-    console.log(`  Detected project name: ${detection.name}  (from ${detection.source}${detection.originUrl ? ` — ${detection.originUrl}` : ''})`);
+    // Concept-level "what is a workspace" copy AND the "Detected
+    // project name: foo (from cwd-basename)" line used to live here.
+    // Both moved out: the explainer above teaches the concept and
+    // already renders the workspace name in its title, so repeating
+    // "Detected project name: foo" in this prompt is redundant. The
+    // detected name still appears INSIDE the bind question itself
+    // (`Create new workspace "foo"…?`), which is where the user
+    // actually needs to see it to accept or rename.
     console.log('');
     let answer;
     try {