peaks-loop-shared 0.0.1

package/dist/fs.d.ts

@@ -0,0 +1,5 @@
+export declare function pathExists(path: string): Promise<boolean>;
+export declare function readText(path: string): Promise<string>;
+export declare function listDirectories(path: string): Promise<string[]>;
+export declare function isDirectory(path: string): Promise<boolean>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAGA,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5D;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGrE;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhE"}

package/dist/fs.js

@@ -0,0 +1,26 @@
+import { access, readdir, readFile, stat } from 'node:fs/promises';
+import { constants } from 'node:fs';
+export async function pathExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readText(path) {
+    return readFile(path, 'utf8');
+}
+export async function listDirectories(path) {
+    const entries = await readdir(path, { withFileTypes: true });
+    return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+}
+export async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * peaks-loop-shared public surface.
+ *
+ * Re-exports the four pure-function utils this package owns:
+ *  1. fs         — file system primitives (pathExists, isDirectory, ...)
+ *  2. paths      — repo-root + skills/schemas/templates dirs + required
+ *                  skill + schema name lists
+ *  3. result     — ResultEnvelope / ok() / fail() + sensitive-error redaction
+ *  4. version    — CLI_VERSION (synced from main package.json by
+ *                  scripts/sync-version.mjs)
+ *
+ * Main peaks-loop package consumes these via `workspace:*` deps:
+ *
+ *   import { ok, fail } from 'peaks-loop-shared';
+ *   import { pathExists } from 'peaks-loop-shared/fs';
+ */
+export * from './fs.js';
+export * from './paths.js';
+export * from './result.js';
+export * from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * peaks-loop-shared public surface.
+ *
+ * Re-exports the four pure-function utils this package owns:
+ *  1. fs         — file system primitives (pathExists, isDirectory, ...)
+ *  2. paths      — repo-root + skills/schemas/templates dirs + required
+ *                  skill + schema name lists
+ *  3. result     — ResultEnvelope / ok() / fail() + sensitive-error redaction
+ *  4. version    — CLI_VERSION (synced from main package.json by
+ *                  scripts/sync-version.mjs)
+ *
+ * Main peaks-loop package consumes these via `workspace:*` deps:
+ *
+ *   import { ok, fail } from 'peaks-loop-shared';
+ *   import { pathExists } from 'peaks-loop-shared/fs';
+ */
+export * from './fs.js';
+export * from './paths.js';
+export * from './result.js';
+export * from './version.js';

package/dist/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const repoRoot: string;
+export declare const skillsDir: string;
+export declare const schemasDir: string;
+export declare const templatesDir: string;
+export declare const requiredSkillNames: readonly ["peaks-code", "peaks-prd", "peaks-ui", "peaks-rd", "peaks-qa", "peaks-sc", "peaks-txt", "peaks-sop"];
+export declare const requiredSchemaFiles: readonly ["artifact-manifest.schema.json", "context-capsule.schema.json", "approval-record.schema.json", "change-impact.schema.json", "refactor-slice-spec.schema.json", "artifact-retention-report.schema.json", "capability-source.schema.json", "capability-item.schema.json", "capability-availability.schema.json", "recommendation-plan.schema.json", "artifact-workspace.schema.json", "mcp-server.schema.json", "mcp-install-spec.schema.json", "mcp-install-plan.schema.json", "mcp-apply-result.schema.json", "openspec-change-summary.schema.json", "openspec-render-request.schema.json", "openspec-validation-result.schema.json", "doctor-report.schema.json", "library-breaking-changes.schema.json"];
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,QAAQ,QAAqC,CAAC;AAC3D,eAAO,MAAM,SAAS,QAA8B,CAAC;AACrD,eAAO,MAAM,UAAU,QAA+B,CAAC;AACvD,eAAO,MAAM,YAAY,QAAiC,CAAC;AAE3D,eAAO,MAAM,kBAAkB,gHASrB,CAAC;AAEX,eAAO,MAAM,mBAAmB,srBAqBtB,CAAC"}

package/dist/paths.js

@@ -0,0 +1,50 @@
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+function findRepoRoot(startPath) {
+    let currentPath = startPath;
+    while (currentPath !== dirname(currentPath)) {
+        if (existsSync(resolve(currentPath, 'package.json')) && existsSync(resolve(currentPath, 'skills'))) {
+            return currentPath;
+        }
+        currentPath = dirname(currentPath);
+    }
+    throw new Error(`Unable to locate Peaks repository root from ${startPath}`);
+}
+const currentFile = fileURLToPath(import.meta.url);
+export const repoRoot = findRepoRoot(dirname(currentFile));
+export const skillsDir = resolve(repoRoot, 'skills');
+export const schemasDir = resolve(repoRoot, 'schemas');
+export const templatesDir = resolve(repoRoot, 'templates');
+export const requiredSkillNames = [
+    'peaks-code',
+    'peaks-prd',
+    'peaks-ui',
+    'peaks-rd',
+    'peaks-qa',
+    'peaks-sc',
+    'peaks-txt',
+    'peaks-sop'
+];
+export const requiredSchemaFiles = [
+    'artifact-manifest.schema.json',
+    'context-capsule.schema.json',
+    'approval-record.schema.json',
+    'change-impact.schema.json',
+    'refactor-slice-spec.schema.json',
+    'artifact-retention-report.schema.json',
+    'capability-source.schema.json',
+    'capability-item.schema.json',
+    'capability-availability.schema.json',
+    'recommendation-plan.schema.json',
+    'artifact-workspace.schema.json',
+    'mcp-server.schema.json',
+    'mcp-install-spec.schema.json',
+    'mcp-install-plan.schema.json',
+    'mcp-apply-result.schema.json',
+    'openspec-change-summary.schema.json',
+    'openspec-render-request.schema.json',
+    'openspec-validation-result.schema.json',
+    'doctor-report.schema.json',
+    'library-breaking-changes.schema.json'
+];

package/dist/result.d.ts

@@ -0,0 +1,23 @@
+export type ResultEnvelope<T> = {
+    ok: boolean;
+    command: string;
+    data: T;
+    warnings: string[];
+    nextActions: string[];
+    code?: string;
+    message?: string;
+    /**
+     * Slice 2026-06-23-audit-4th #B3: opaque per-failure correlation
+     * id. Always present on `fail()` envelopes. Lets a user say
+     * "my last failure was errorId=X; show me the JSONL log lines
+     * tagged with X" without grepping on a code/message that may be
+     * repeated. Also written to the next writeLogEntry call (best-effort)
+     * by the caller so the log entry can be cross-referenced.
+     */
+    errorId?: string;
+};
+export declare function ok<T>(command: string, data: T, warnings?: string[], nextActions?: string[]): ResultEnvelope<T>;
+export declare function fail<T>(command: string, code: string, message: string, data: T, nextActions?: string[]): ResultEnvelope<T>;
+export declare function getErrorMessage(error: unknown): string;
+export declare function redactSensitiveErrorMessage(message: string): string;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,GAAE,MAAM,EAAO,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAEtH;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAe9H;AAiBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/result.js

@@ -0,0 +1,46 @@
+import { randomUUID } from 'node:crypto';
+export function ok(command, data, warnings = [], nextActions = []) {
+    return { ok: true, command, data, warnings, nextActions };
+}
+export function fail(command, code, message, data, nextActions = []) {
+    // Slice 2026-06-23-audit-4th #B3: mint a fresh errorId per failure.
+    // The id is opaque (uuid v4) and never reused; downstream log
+    // entries from the same code path can carry the same id for
+    // post-hoc correlation.
+    return {
+        ok: false,
+        command,
+        code,
+        message: redactSensitiveErrorMessage(message),
+        data,
+        warnings: [],
+        nextActions,
+        errorId: randomUUID()
+    };
+}
+const SENSITIVE_ERROR_PATTERNS = [
+    /\bBearer\s+[A-Za-z0-9._~+/=-]{12,}\b/gi,
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----/g,
+    /\b(?:api[\s_-]?key|token|password|secret)\s*[:=]\s*['\"]?[^\s'\"]{8,}/gi,
+    /\bAKIA[0-9A-Z]{16}\b/g,
+    /\bAIza[0-9A-Za-z_-]{20,}\b/g,
+    /\bghp_[0-9A-Za-z_]{20,}\b/g,
+    /\bgithub_pat_[0-9A-Za-z_]{20,}\b/g,
+    /\bglpat-[0-9A-Za-z_-]{20,}\b/g,
+    /\bxox[abprse]-[0-9A-Za-z-]{20,}\b/g,
+    /\bsk-[A-Za-z0-9_-]{16,}\b/g,
+    /\beyJ[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b/g,
+    /(secret|token|password|api[-_ ]?key)/gi
+];
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return 'Unexpected error';
+}
+export function redactSensitiveErrorMessage(message) {
+    return SENSITIVE_ERROR_PATTERNS.reduce((redacted, pattern) => redacted.replace(pattern, '[redacted]'), message);
+}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const CLI_VERSION = "4.0.0-beta.15";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,kBAAkB,CAAC"}

package/dist/version.js

@@ -0,0 +1 @@
+export const CLI_VERSION = "4.0.0-beta.15";

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "peaks-loop-shared",
+  "version": "0.0.1",
+  "description": "Shared pure-function utils for peaks-loop workspace packages (fs / paths / result / version). Slice 3a.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./fs": {
+      "types": "./dist/fs.d.ts",
+      "default": "./dist/fs.js"
+    },
+    "./paths": {
+      "types": "./dist/paths.d.ts",
+      "default": "./dist/paths.js"
+    },
+    "./result": {
+      "types": "./dist/result.d.ts",
+      "default": "./dist/result.js"
+    },
+    "./version": {
+      "types": "./dist/version.d.ts",
+      "default": "./dist/version.js"
+    }
+  },
+  "files": [
+    "dist/**"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}