peaks-cli 1.3.3 → 1.3.4

package/dist/src/services/session/getSessionDir.js

@@ -0,0 +1,27 @@
+/**
+ * Canonical session-directory resolver.
+ *
+ * As of slice 2026-06-05-peaks-runtime-layer the per-session workspace
+ * lives at `<root>/.peaks/_runtime/<sessionId>/` (NOT at the legacy
+ * `<root>/.peaks/<sessionId>/` location). All **write** paths MUST route
+ * through this helper. The legacy top-level path is preserved as a
+ * back-compat **read** fallback only (see
+ * `src/services/artifacts/request-artifact-service.ts:662` etc.).
+ *
+ * The corresponding test in
+ * `tests/unit/services/session/session-dir-canonical.test.ts` enforces
+ * two invariants:
+ *
+ *   (a) `getSessionDir(root, sid)` returns `<root>/.peaks/_runtime/<sid>`.
+ *   (b) A static scan of `src/` flags any direct join of `.peaks` +
+ *       `sessionId` that does NOT route through this resolver. The
+ *       back-compat **read** sites are excluded by explicit allow-list.
+ *
+ * @param projectRoot - Absolute path to the project root.
+ * @param sessionId - The session identifier (e.g. `2026-06-06-session-5b1095`).
+ * @returns Absolute path to the canonical session directory.
+ */
+import { join } from 'node:path';
+export function getSessionDir(projectRoot, sessionId) {
+    return join(projectRoot, '.peaks', '_runtime', sessionId);
+}

package/dist/src/services/session/index.d.ts

@@ -1 +1,2 @@
 export { ensureSession, getSessionId, getCurrentSessionDir, listSessions, getSessionMeta, setSessionMeta, setSessionTitle, listSessionMetas, getProjectScanPath, hasProjectScan, setCurrentSessionBinding, rotateSessionBinding, type SessionInfo, type SessionMeta } from './session-manager.js';
+export { getSessionDir } from './getSessionDir.js';

package/dist/src/services/session/index.js

@@ -1 +1,2 @@
 export { ensureSession, getSessionId, getCurrentSessionDir, listSessions, getSessionMeta, setSessionMeta, setSessionTitle, listSessionMetas, getProjectScanPath, hasProjectScan, setCurrentSessionBinding, rotateSessionBinding } from './session-manager.js';
+export { getSessionDir } from './getSessionDir.js';

package/dist/src/services/standards/ide-aware-standards-service.d.ts

@@ -0,0 +1,94 @@
+/**
+ * IDE-aware wrapper for `peaks standards init` / `peaks standards update`.
+ *
+ * Slice #011-2026-06-07-ide-adapter-resource-profile: the original
+ * `executeProjectStandardsInit` / `executeProjectStandardsUpdate` always
+ * wrote to `CLAUDE.md` + `.claude/rules/**` regardless of which IDE
+ * the user was running. This wrapper dispatches on the IDE detected
+ * (or explicitly requested via `--ide`) and falls back to the legacy
+ * Claude Code path with a stderr warning when the detected IDE has
+ * no `standardsProfile` declared (Trae in slice 1.3.2).
+ *
+ * Two entry points:
+ *
+ *   - `executeProjectStandardsInitIdeAware` — same signature as the
+ *     underlying `executeProjectStandardsInit`, plus an optional
+ *     `ideId` override that bypasses detection.
+ *   - `executeProjectStandardsUpdateIdeAware` — same shape, for the
+ *     `update` flow.
+ *
+ * Detection precedence:
+ *   1. Explicit `options.ideId` (CLI `--ide` flag)
+ *   2. `IdeRegistry.detect()` from cwd (or the `projectRoot` if given)
+ *   3. `null` (no IDE detected) → fall back to the legacy Claude Code path
+ *
+ * Fallback behavior: when the resolved IDE has no `standardsProfile`
+ * declared, the wrapper STILL calls the legacy Claude Code writer
+ * (so the user gets the files they would have gotten before slice #011)
+ * and emits a stderr warning with the IDE id and the fact that the
+ * adapter is UNVERIFIED for the standards profile. This keeps the
+ * "Trae is UNVERIFIED, ship a working file tree, surface the gap"
+ * contract intact.
+ */
+import type { IdeId } from '../ide/ide-types.js';
+import { detectAllResourceTargets, getStandardsProfile } from '../ide/resource-profile.js';
+import { type ProjectStandardsInitOptions, type ProjectStandardsInitResult, type ProjectStandardsUpdateResult } from './project-standards-service.js';
+export type { ProjectStandardsInitResult, ProjectStandardsUpdateResult };
+export type ProjectStandardsIdeAwareOptions = ProjectStandardsInitOptions & {
+    /**
+     * Explicit IDE override. When set, bypasses `IdeRegistry.detect()`
+     * (cwd + env heuristics) and uses the provided IDE id directly.
+     * Mirrors the `peaks hooks install --ide <id>` pattern.
+     */
+    readonly ideId?: IdeId;
+};
+export type ProjectStandardsUpdateIdeAwareOptions = ProjectStandardsInitOptions & {
+    /** Explicit IDE override. See {@link ProjectStandardsIdeAwareOptions}. */
+    readonly ideId?: IdeId;
+};
+/**
+ * Resolve the active IDE id for a standards call. Order of precedence:
+ *   1. explicit `options.ideId`
+ *   2. `IdeRegistry.detect()` from `options.projectRoot`
+ *   3. `null` (no detected IDE — caller falls back to legacy)
+ */
+export declare function resolveStandardsIdeId(options: {
+    readonly projectRoot: string;
+    readonly ideId?: IdeId;
+}): IdeId | null;
+/**
+ * Run `peaks standards init` with IDE-aware dispatch.
+ *
+ * When the resolved IDE has a `standardsProfile`, the call still
+ * delegates to the existing `executeProjectStandardsInit` (the
+ * profile maps to the Claude Code path; future per-IDE writers
+ * plug in here). When the IDE is unregistered for the standards
+ * profile, the call delegates to the legacy path + emits a stderr
+ * warning.
+ */
+export declare function executeProjectStandardsInitIdeAware(options: ProjectStandardsIdeAwareOptions): ProjectStandardsInitResult;
+/**
+ * Run `peaks standards update` with IDE-aware dispatch.
+ *
+ * Same dispatch rules as `executeProjectStandardsInitIdeAware`.
+ */
+export declare function executeProjectStandardsUpdateIdeAware(options: ProjectStandardsUpdateIdeAwareOptions): ProjectStandardsUpdateResult;
+/**
+ * Test seam + integration-test helper: returns the resolved IDE id
+ * for the call, plus the active standards profile. Exported for
+ * the integration test in `tests/unit/standards/ide-aware-standards-service.test.ts`
+ * to assert the dispatch decision without running the full write.
+ */
+export declare function inspectStandardsDispatch(options: {
+    readonly projectRoot: string;
+    readonly ideId?: IdeId;
+}): {
+    readonly ideId: IdeId | null;
+    readonly profile: ReturnType<typeof getStandardsProfile>;
+};
+/**
+ * Test seam: the resource-profile accessor exposes
+ * `detectAllResourceTargets` for callers that need to enumerate
+ * across all registered IDEs. Re-exported here for convenience.
+ */
+export { detectAllResourceTargets };

package/dist/src/services/standards/ide-aware-standards-service.js

@@ -0,0 +1,89 @@
+import { detectAllResourceTargets, getStandardsProfile, } from '../ide/resource-profile.js';
+import { executeProjectStandardsInit, executeProjectStandardsUpdate, } from './project-standards-service.js';
+import { detectInstalledIde } from '../ide/ide-detector.js';
+function warnUnregisteredIde(ideId, projectRoot) {
+    process.stderr.write(`peaks standards: IDE '${ideId}' has no standardsProfile declared; ` +
+        `falling back to the legacy Claude Code path (CLAUDE.md + .claude/rules/**) ` +
+        `for project '${projectRoot}'. This is a slice #011 follow-up gap; ` +
+        `see .peaks/memory/ide-adapter-resource-profile-framework.md.\n`);
+}
+function warnNoIdeDetected(projectRoot) {
+    process.stderr.write(`peaks standards: no IDE detected in '${projectRoot}'; ` +
+        `writing to the legacy Claude Code path (CLAUDE.md + .claude/rules/**). ` +
+        `Pass --ide <id> to bypass detection.\n`);
+}
+/**
+ * Resolve the active IDE id for a standards call. Order of precedence:
+ *   1. explicit `options.ideId`
+ *   2. `IdeRegistry.detect()` from `options.projectRoot`
+ *   3. `null` (no detected IDE — caller falls back to legacy)
+ */
+export function resolveStandardsIdeId(options) {
+    if (options.ideId !== undefined) {
+        return options.ideId;
+    }
+    return detectInstalledIde(options.projectRoot);
+}
+/**
+ * Run `peaks standards init` with IDE-aware dispatch.
+ *
+ * When the resolved IDE has a `standardsProfile`, the call still
+ * delegates to the existing `executeProjectStandardsInit` (the
+ * profile maps to the Claude Code path; future per-IDE writers
+ * plug in here). When the IDE is unregistered for the standards
+ * profile, the call delegates to the legacy path + emits a stderr
+ * warning.
+ */
+export function executeProjectStandardsInitIdeAware(options) {
+    const ideId = resolveStandardsIdeId(options);
+    if (ideId === null) {
+        warnNoIdeDetected(options.projectRoot);
+        return executeProjectStandardsInit(options);
+    }
+    const profile = getStandardsProfile(ideId);
+    if (profile === null) {
+        warnUnregisteredIde(ideId, options.projectRoot);
+        return executeProjectStandardsInit(options);
+    }
+    // Claude Code path: profile matches the legacy writer. Future per-IDE
+    // writers (markdown+frontmatter, multiple rule roots, etc.) plug in
+    // here by branching on `profile.format` / `profile.rulesDir`.
+    return executeProjectStandardsInit(options);
+}
+/**
+ * Run `peaks standards update` with IDE-aware dispatch.
+ *
+ * Same dispatch rules as `executeProjectStandardsInitIdeAware`.
+ */
+export function executeProjectStandardsUpdateIdeAware(options) {
+    const ideId = resolveStandardsIdeId(options);
+    if (ideId === null) {
+        warnNoIdeDetected(options.projectRoot);
+        return executeProjectStandardsUpdate(options);
+    }
+    const profile = getStandardsProfile(ideId);
+    if (profile === null) {
+        warnUnregisteredIde(ideId, options.projectRoot);
+        return executeProjectStandardsUpdate(options);
+    }
+    return executeProjectStandardsUpdate(options);
+}
+/**
+ * Test seam + integration-test helper: returns the resolved IDE id
+ * for the call, plus the active standards profile. Exported for
+ * the integration test in `tests/unit/standards/ide-aware-standards-service.test.ts`
+ * to assert the dispatch decision without running the full write.
+ */
+export function inspectStandardsDispatch(options) {
+    const ideId = resolveStandardsIdeId(options);
+    if (ideId === null) {
+        return { ideId: null, profile: null };
+    }
+    return { ideId, profile: getStandardsProfile(ideId) };
+}
+/**
+ * Test seam: the resource-profile accessor exposes
+ * `detectAllResourceTargets` for callers that need to enumerate
+ * across all registered IDEs. Re-exported here for convenience.
+ */
+export { detectAllResourceTargets };

package/dist/src/services/standards/project-standards-service.d.ts

@@ -68,7 +68,7 @@ export type ProjectStandardsUpdateSummary = {
         readonly reviewSuggestions: string[];
     };
 };
-type ProjectStandardsInitOptions = {
+export type ProjectStandardsInitOptions = {
     readonly projectRoot: string;
     readonly language?: string;
     readonly apply?: boolean;
@@ -79,4 +79,3 @@ export declare function executeProjectStandardsInit(options: ProjectStandardsIni
 export declare function executeProjectStandardsUpdate(options: ProjectStandardsInitOptions): ProjectStandardsUpdateResult;
 export declare function summarizeProjectStandardsInitResult(result: ProjectStandardsInitResult): ProjectStandardsInitSummary;
 export declare function summarizeProjectStandardsUpdateResult(result: ProjectStandardsUpdateResult): ProjectStandardsUpdateSummary;
-export {};

package/dist/src/shared/version.d.ts

@@ -1 +1 @@
-export declare const CLI_VERSION = "1.3.3";
+export declare const CLI_VERSION = "1.3.4";

package/dist/src/shared/version.js

@@ -1 +1 @@
-export const CLI_VERSION = "1.3.3";
+export const CLI_VERSION = "1.3.4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peaks-cli",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "Cross-AI-IDE workflow-gating CLI + skill family (Claude Code shipped, Trae in progress; Codex / Cursor / Qoder / Tongyi Lingma on the roadmap).",
   "author": "SquabbyZ",
   "license": "MIT",

package/scripts/install-skills.mjs

@@ -363,6 +363,78 @@ function resolveProjectRoot(options) {
   return projectRoot ? resolve(projectRoot) : null;
 }
 
+/**
+ * Slice #011: Detect the installed IDE for the postinstall dispatch layer.
+ *
+ * Mirrors `src/services/ide/ide-detector.ts:detectInstalledIde` (cwd heuristic)
+ * but inlined here because `install-skills.mjs` is a plain `.mjs` script and
+ * cannot import the TS service at runtime. The dispatch:
+ *   - Look for `.claude`, `.trae`, `.codex`, `.cursor`, `.qoder`,
+ *     `.tongyi-lingma` in the project root in that insertion order
+ *     (matches the registry's adapter order in `src/services/ide/ide-registry.ts`).
+ *   - Returns the first match, or `null` if no adapter's directory is present.
+ *
+ * If the resolved IDE has no `skillInstall` declared (Trae in slice 1.3.2),
+ * the caller falls back to the legacy `~/.claude/{skills,output-styles}` path
+ * + emits a stderr warning. The dispatch is conservative: the env-var
+ * overrides `PEAKS_CLAUDE_SKILLS_DIR` / `PEAKS_CLAUDE_OUTPUT_STYLES_DIR`
+ * continue to work, and the legacy default is preserved.
+ */
+const IDE_DETECTION_DIRS = [
+  { id: 'claude-code', dir: '.claude' },
+  { id: 'trae', dir: '.trae' },
+  { id: 'codex', dir: '.codex' },
+  { id: 'cursor', dir: '.cursor' },
+  { id: 'qoder', dir: '.qoder' },
+  { id: 'tongyi-lingma', dir: '.tongyi-lingma' },
+];
+
+const IDE_SKILL_INSTALL_PROFILES = {
+  'claude-code': {
+    skillsDir: join(homedir(), '.claude', 'skills'),
+    outputStylesDir: join(homedir(), '.claude', 'output-styles'),
+    envVar: 'PEAKS_CLAUDE_SKILLS_DIR',
+    outputStylesEnvVar: 'PEAKS_CLAUDE_OUTPUT_STYLES_DIR',
+  },
+  'trae': null,
+  'codex': null,
+  'cursor': null,
+  'qoder': null,
+  'tongyi-lingma': null,
+};
+
+function detectInstalledIdeId(projectRoot) {
+  if (!projectRoot) return null;
+  for (const { id, dir } of IDE_DETECTION_DIRS) {
+    if (existsSync(join(projectRoot, dir))) {
+      return id;
+    }
+  }
+  return null;
+}
+
+function resolveIdeSkillInstallProfile(ideId) {
+  if (ideId === null) return null;
+  return IDE_SKILL_INSTALL_PROFILES[ideId] ?? null;
+}
+
+function warnUnverifiedIde(ideId, projectRoot) {
+  process.stderr.write(
+    `peaks install-skills: IDE '${ideId}' has no skillInstall profile declared; ` +
+      `falling back to the legacy Claude Code path (~/.claude/skills + ~/.claude/output-styles) ` +
+      `for project '${projectRoot}'. This is a slice #011 follow-up gap; ` +
+      `see .peaks/memory/ide-adapter-resource-profile-framework.md.\n`
+  );
+}
+
+function warnNoIdeDetected(projectRoot) {
+  process.stderr.write(
+    `peaks install-skills: no IDE detected in '${projectRoot ?? '(project root unknown)'}'; ` +
+      `installing to the legacy Claude Code path (~/.claude/skills + ~/.claude/output-styles). ` +
+      `Set PEAKS_CLAUDE_SKILLS_DIR / PEAKS_CLAUDE_OUTPUT_STYLES_DIR to override.\n`
+  );
+}
+
 function writeMergedConfig(configPath, label, defaults, writeConfig) {
   const existing = readConfigFile(configPath, label);
   const next = { ...(existing === null ? defaults : mergeMissingConfigValues(existing, defaults)), version: defaults.version };
@@ -424,12 +496,37 @@ export function installProjectConfig(options = {}) {
 export function installBundledSkills(options = {}) {
   const packageRoot = resolvePackageRoot(options);
   const skillsRoot = join(packageRoot, 'skills');
-  const targetRoot = resolve(options.targetRoot ?? process.env.PEAKS_CLAUDE_SKILLS_DIR ?? join(homedir(), '.claude', 'skills'));
 
   if (process.env.PEAKS_SKIP_SKILL_INSTALL === '1' || !existsSync(skillsRoot)) {
     return createInstallResult();
   }
 
+  // Slice #011: IDE-aware dispatch. Precedence (highest first):
+  //   1. explicit options.targetRoot            (test / hook override)
+  //   2. options.ideId skillInstall.skillsDir   (per-IDE dispatch)
+  //   3. PEAKS_CLAUDE_SKILLS_DIR env var        (legacy back-compat)
+  //   4. detected IDE's skillInstall.skillsDir  (auto-detect from projectRoot)
+  //   5. legacy default (~/.claude/skills)      (no-IDE fallback)
+  const projectRoot = resolveProjectRoot(options);
+  const detectedIdeId = detectInstalledIdeId(projectRoot);
+  const detectedProfile = resolveIdeSkillInstallProfile(detectedIdeId);
+
+  if (options.targetRoot === undefined && options.ideId === undefined && detectedProfile === null && detectedIdeId !== null) {
+    warnUnverifiedIde(detectedIdeId, projectRoot ?? '(project root unknown)');
+  }
+  if (options.targetRoot === undefined && options.ideId === undefined && detectedIdeId === null && projectRoot !== null) {
+    warnNoIdeDetected(projectRoot);
+  }
+
+  const profileSkillsDir = detectedProfile?.skillsDir ?? null;
+  const targetRoot = resolve(
+    options.targetRoot
+      ?? (options.ideId !== undefined ? resolveIdeSkillInstallProfile(options.ideId)?.skillsDir ?? null : null)
+      ?? process.env.PEAKS_CLAUDE_SKILLS_DIR
+      ?? profileSkillsDir
+      ?? join(homedir(), '.claude', 'skills')
+  );
+
   const installed = [];
   const skipped = [];
   mkdirSync(targetRoot, { recursive: true });
@@ -485,12 +582,25 @@ export function installBundledSkills(options = {}) {
 export function installBundledOutputStyles(options = {}) {
   const packageRoot = resolvePackageRoot(options);
   const outputStylesRoot = join(packageRoot, 'output-styles');
-  const targetRoot = resolve(options.targetRoot ?? process.env.PEAKS_CLAUDE_OUTPUT_STYLES_DIR ?? join(homedir(), '.claude', 'output-styles'));
 
   if (process.env.PEAKS_SKIP_SKILL_INSTALL === '1' || !existsSync(outputStylesRoot)) {
     return createInstallResult();
   }
 
+  // Slice #011: IDE-aware dispatch. Same precedence as installBundledSkills.
+  const projectRoot = resolveProjectRoot(options);
+  const detectedIdeId = detectInstalledIdeId(projectRoot);
+  const detectedProfile = resolveIdeSkillInstallProfile(detectedIdeId);
+
+  const profileOutputStylesDir = detectedProfile?.outputStylesDir ?? null;
+  const targetRoot = resolve(
+    options.targetRoot
+      ?? (options.ideId !== undefined ? resolveIdeSkillInstallProfile(options.ideId)?.outputStylesDir ?? null : null)
+      ?? process.env.PEAKS_CLAUDE_OUTPUT_STYLES_DIR
+      ?? profileOutputStylesDir
+      ?? join(homedir(), '.claude', 'output-styles')
+  );
+
   const installed = [];
   const skipped = [];
   mkdirSync(targetRoot, { recursive: true });

package/skills/peaks-ide/SKILL.md

@@ -109,7 +109,7 @@ Every successful execution writes one JSON line to `.peaks/_runtime/<sid>/ide-on
 {"timestamp":"2026-06-06T19:55:00Z","intent":"first-time-install","detected_ide":"trae","cli_invocations":["peaks hooks install --project <repo>","peaks statusline install --project <repo>"],"outcome":"success","session_id":"2026-06-06-session-22f08c"}
 ```
 
-The audit log is **machine-readable** (so `peaks project dashboard` can read it and surface "you installed peaks for Trae on 2026-06-06") and **human-readable** (so the user can `cat` it to see the install history). The skill does NOT write the log file itself — it delegates to `peaks project dashboard` (the canonical log writer, per the dev-preference red line "skill-first for workflow, CLI-backed for gates / side effects"). The audit log writer is a CLI primitive, not a per-skill helper; the skill body MUST NOT introduce a new `peaks <cmd>` for the log writer.
+The audit log is **machine-readable** (so `peaks project dashboard` can read it and surface "you installed peaks for Trae on 2026-06-06") and **human-readable** (so the user can `cat` it to see the install history). The skill does NOT write the log file itself — it delegates to `peaks project dashboard` (the canonical log writer, per the dev-preference red line "skill-first for workflow, CLI-backed for gates / side effects"). The audit log writer is a CLI primitive, not a per-skill helper; the skill body MUST NOT introduce a new `peaks <cmd>` for the log writer. The thin helper that writes the log is `scripts/peaks-ide-audit-log.mjs`; see [audit-log-helper.md](references/audit-log-helper.md) for its CLI surface and contract.
 
 ## Boundaries
 

package/skills/peaks-ide/references/audit-log-helper.md

@@ -0,0 +1,52 @@
+---
+name: peaks-ide-audit-log-helper
+description: Thin Node helper that writes a single JSONL line to `.peaks/audit/peaks-ide-<UTC-date>.log`. Reachable from the peaks-ide SKILL.md Step 5 escape hatch. NOT a `peaks <cmd>` CLI primitive (slice #2 closeout + dev-preference red line).
+---
+
+# peaks-ide audit log helper
+
+The peaks-ide skill's Step 5 (`audit log`) delegates the JSONL write to
+`scripts/peaks-ide-audit-log.mjs`. The helper is a thin Node script, not a
+new `peaks <cmd>`, and is the single source of truth for the audit log
+shape (machine + human readable, one JSON object per line).
+
+## Why a thin helper, not a CLI primitive
+
+Per `.peaks/memory/peaks-ide-skill-ac-10-audit-log-writer-is-a-thin-helper-not-a-separate-cli-primitive.md`
+(slice #2 closeout), the audit log writer is reachable from the skill's
+Step 5 escape hatch but is NOT a new top-level `peaks <cmd>`. The
+`peaks project dashboard` command reads the log via the `audit` scan; the
+helper writes the log. The dev-preference red line "Default-no on new CLI
+commands" still applies — if the audit-trail becomes critical in a future
+slice, the helper can be promoted to a CLI primitive at that point.
+
+## CLI surface
+
+```
+node scripts/peaks-ide-audit-log.mjs --project <repo> --event <name> --adapter <id> [--ok true|false] [--detail <json>] [--dry-run]
+```
+
+| Flag | Required | Description |
+|---|---|---|
+| `--project <path>` | yes | Target project root (parent of `.peaks/`) |
+| `--event <name>` | yes | Event identifier (`install`, `statusline`, `hook-handle`, ...) |
+| `--adapter <id>` | yes | Adapter id (`claude-code`, `trae`, ...) |
+| `--ok <bool>` | no, default `true` | Outcome flag — `false` to record a failure |
+| `--detail <json>` | no | Free-form JSON object attached to the entry |
+| `--dry-run` | no | Print the would-be line; do not write |
+
+## Log line shape
+
+```json
+{"timestamp":"2026-06-07T16:00:00.000Z","event":"install","adapter":"trae","ok":true}
+```
+
+The log file path is `<projectRoot>/.peaks/audit/peaks-ide-<UTC-date>.log`
+and is gitignored per the repo root `.gitignore` (`.peaks/audit/`).
+
+## Contract pinned by tests
+
+`tests/unit/skills/peaks-ide/audit-log-helper.test.ts` pins 4 sub-cases
+(per AC-5): helper is at the documented path, write emits one JSONL line
+with `timestamp + event + adapter + ok`, the log path is in `.gitignore`,
+and `--dry-run` returns the would-be line without writing.