@outcomeeng/spx 0.3.0 → 0.3.2

package/dist/cli.js

@@ -1707,6 +1707,17 @@ var PRIORITY_ORDER = {
   low: 2
 };
 var DEFAULT_PRIORITY = "medium";
+var SESSION_FRONT_MATTER = {
+  PRIORITY: "priority",
+  TAGS: "tags",
+  ID: "id",
+  BRANCH: "branch",
+  CREATED_AT: "created_at",
+  AGENT_SESSION_ID: "agent_session_id",
+  WORKING_DIRECTORY: "working_directory",
+  SPECS: "specs",
+  FILES: "files"
+};
 
 // src/session/list.ts
 var FRONT_MATTER_PATTERN = /^---\r?\n([\s\S]*?)\r?\n(?:---|\.\.\.)\r?\n?/;
@@ -1729,36 +1740,28 @@ function parseSessionMetadata(content) {
         tags: []
       };
     }
-    const priority = isValidPriority(parsed.priority) ? parsed.priority : DEFAULT_PRIORITY;
-    let tags = [];
-    if (Array.isArray(parsed.tags)) {
-      tags = parsed.tags.filter((t) => typeof t === "string");
-    }
-    const metadata = {
-      priority,
-      tags
-    };
-    if (typeof parsed.id === "string") {
-      metadata.id = parsed.id;
-    }
-    if (typeof parsed.branch === "string") {
-      metadata.branch = parsed.branch;
-    }
-    if (typeof parsed.created_at === "string") {
-      metadata.createdAt = parsed.created_at;
-    }
-    if (typeof parsed.working_directory === "string") {
-      metadata.workingDirectory = parsed.working_directory;
-    }
-    if (Array.isArray(parsed.specs)) {
-      metadata.specs = parsed.specs.filter(
-        (s) => typeof s === "string"
-      );
-    }
-    if (Array.isArray(parsed.files)) {
-      metadata.files = parsed.files.filter(
-        (f) => typeof f === "string"
-      );
+    const rawPriority = parsed[SESSION_FRONT_MATTER.PRIORITY];
+    const priority = isValidPriority(rawPriority) ? rawPriority : DEFAULT_PRIORITY;
+    const rawTags = parsed[SESSION_FRONT_MATTER.TAGS];
+    const tags = Array.isArray(rawTags) ? rawTags.filter((t) => typeof t === "string") : [];
+    const metadata = { priority, tags };
+    const id = parsed[SESSION_FRONT_MATTER.ID];
+    if (typeof id === "string") metadata.id = id;
+    const branch = parsed[SESSION_FRONT_MATTER.BRANCH];
+    if (typeof branch === "string") metadata.branch = branch;
+    const createdAt = parsed[SESSION_FRONT_MATTER.CREATED_AT];
+    if (typeof createdAt === "string") metadata.createdAt = createdAt;
+    const agentSessionId = parsed[SESSION_FRONT_MATTER.AGENT_SESSION_ID];
+    if (typeof agentSessionId === "string") metadata.agentSessionId = agentSessionId;
+    const workingDirectory = parsed[SESSION_FRONT_MATTER.WORKING_DIRECTORY];
+    if (typeof workingDirectory === "string") metadata.workingDirectory = workingDirectory;
+    const specs = parsed[SESSION_FRONT_MATTER.SPECS];
+    if (Array.isArray(specs)) {
+      metadata.specs = specs.filter((s) => typeof s === "string");
+    }
+    const files = parsed[SESSION_FRONT_MATTER.FILES];
+    if (Array.isArray(files)) {
+      metadata.files = files.filter((f) => typeof f === "string");
     }
     return metadata;
   } catch {
@@ -1855,6 +1858,16 @@ import { join as join5, resolve as resolve4 } from "path";
 
 // src/session/create.ts
 var MIN_CONTENT_LENGTH = 1;
+var FRONT_MATTER_OPEN = /^---\r?\n/;
+function preFillSessionContent(content, params) {
+  const match = FRONT_MATTER_OPEN.exec(content);
+  if (!match) return content;
+  const lines = [`${SESSION_FRONT_MATTER.CREATED_AT}: "${params.createdAt.toISOString()}"`];
+  if (params.agentSessionId !== void 0) {
+    lines.push(`${SESSION_FRONT_MATTER.AGENT_SESSION_ID}: "${params.agentSessionId}"`);
+  }
+  return match[0] + lines.join("\n") + "\n" + content.slice(match[0].length);
+}
 function validateSessionContent(content) {
   if (!content || content.trim().length < MIN_CONTENT_LENGTH) {
     return {
@@ -1892,7 +1905,12 @@ ${content}`;
 async function handoffCommand(options) {
   const { config, warning } = await resolveSessionConfig({ sessionsDir: options.sessionsDir });
   const sessionId = generateSessionId();
-  const fullContent = buildSessionContent(options.content);
+  const baseContent = buildSessionContent(options.content);
+  const agentSessionId = process.env.CLAUDE_SESSION_ID ?? process.env.CODEX_THREAD_ID;
+  const fullContent = preFillSessionContent(baseContent, {
+    createdAt: /* @__PURE__ */ new Date(),
+    agentSessionId
+  });
   const validation = validateSessionContent(fullContent);
   if (!validation.valid) {
     throw new SessionInvalidContentError(validation.error ?? "Unknown validation error");
@@ -4986,6 +5004,8 @@ function formatSummary(options) {
 
 // src/validation/steps/eslint.ts
 import { spawn } from "child_process";
+import { existsSync as existsSync3 } from "fs";
+import { join as join15 } from "path";
 
 // src/validation/types.ts
 var VALIDATION_SCOPES = {
@@ -5035,7 +5055,10 @@ async function validateESLint(context, runner = defaultEslintProcessRunner) {
       cacheFile: CACHE_PATHS.ESLINT,
       configFile: eslintConfigFile
     });
-    const eslintProcess = runner.spawn("npx", eslintArgs, {
+    const localBin = join15(projectRoot, "node_modules", ".bin", "eslint");
+    const binary = existsSync3(localBin) ? localBin : "npx";
+    const spawnArgs = binary === "npx" ? eslintArgs : eslintArgs.slice(1);
+    const eslintProcess = runner.spawn(binary, spawnArgs, {
       cwd: projectRoot,
       stdio: "inherit"
     });
@@ -5064,6 +5087,8 @@ function validationEnabled(envVarKey, defaults2 = {}) {
 
 // src/validation/steps/knip.ts
 import { spawn as spawn2 } from "child_process";
+import { existsSync as existsSync4 } from "fs";
+import { join as join16 } from "path";
 var defaultKnipProcessRunner = { spawn: spawn2 };
 async function validateKnip(typescriptScope, runner = defaultKnipProcessRunner) {
   try {
@@ -5072,7 +5097,9 @@ async function validateKnip(typescriptScope, runner = defaultKnipProcessRunner)
       return { success: true };
     }
     return new Promise((resolve6) => {
-      const knipProcess = runner.spawn("npx", ["knip"], {
+      const localBin = join16(process.cwd(), "node_modules", ".bin", "knip");
+      const binary = existsSync4(localBin) ? localBin : "npx";
+      const knipProcess = runner.spawn(binary, binary === "npx" ? ["knip"] : [], {
         cwd: process.cwd(),
         stdio: "pipe"
       });
@@ -5245,8 +5272,8 @@ function formatLoc(loc) {
 }
 
 // src/validation/steps/markdown.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
-import { basename, join as join15 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync2 } from "fs";
+import { basename, join as join17 } from "path";
 import { main as markdownlintMain } from "markdownlint-cli2";
 import relativeLinksRule from "markdownlint-rule-relative-links";
 var DEFAULT_DIRECTORY_NAMES = ["spx", "docs"];
@@ -5272,11 +5299,11 @@ function buildMarkdownlintConfig(directoryName) {
   };
 }
 function getDefaultDirectories(projectRoot) {
-  return DEFAULT_DIRECTORY_NAMES.map((name) => join15(projectRoot, name)).filter((dir) => existsSync3(dir));
+  return DEFAULT_DIRECTORY_NAMES.map((name) => join17(projectRoot, name)).filter((dir) => existsSync5(dir));
 }
 function getExcludeGlobs(spxDir) {
-  const excludePath = join15(spxDir, EXCLUDE_FILENAME);
-  if (!existsSync3(excludePath)) {
+  const excludePath = join17(spxDir, EXCLUDE_FILENAME);
+  if (!existsSync5(excludePath)) {
     return [];
   }
   const content = readFileSync2(excludePath, "utf-8");
@@ -5339,7 +5366,7 @@ async function validateDirectory(directory, config, projectRoot, ignoreGlobs = [
       if (parsed) {
         errors.push({
           ...parsed,
-          file: join15(directory, parsed.file)
+          file: join17(directory, parsed.file)
         });
       }
     }
@@ -5384,16 +5411,16 @@ async function markdownCommand(options) {
 
 // src/validation/steps/typescript.ts
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync4, mkdirSync, rmSync, writeFileSync } from "fs";
+import { existsSync as existsSync6, mkdirSync, rmSync, writeFileSync } from "fs";
 import { mkdtemp } from "fs/promises";
 import { tmpdir } from "os";
-import { isAbsolute as isAbsolute3, join as join16 } from "path";
+import { isAbsolute as isAbsolute3, join as join18 } from "path";
 var defaultTypeScriptProcessRunner = { spawn: spawn3 };
 var defaultTypeScriptDeps = {
   mkdtemp,
   writeFileSync,
   rmSync,
-  existsSync: existsSync4,
+  existsSync: existsSync6,
   mkdirSync
 };
 function buildTypeScriptArgs(context) {
@@ -5401,19 +5428,19 @@ function buildTypeScriptArgs(context) {
   return scope === VALIDATION_SCOPES.FULL ? ["tsc", "--noEmit"] : ["tsc", "--project", configFile];
 }
 async function createFileSpecificTsconfig(scope, files, deps = defaultTypeScriptDeps) {
-  const tempDir = await deps.mkdtemp(join16(tmpdir(), "validate-ts-"));
-  const configPath = join16(tempDir, "tsconfig.json");
+  const tempDir = await deps.mkdtemp(join18(tmpdir(), "validate-ts-"));
+  const configPath = join18(tempDir, "tsconfig.json");
   const baseConfigFile = TSCONFIG_FILES[scope];
   const projectRoot = process.cwd();
-  const absoluteFiles = files.map((file) => isAbsolute3(file) ? file : join16(projectRoot, file));
+  const absoluteFiles = files.map((file) => isAbsolute3(file) ? file : join18(projectRoot, file));
   const tempConfig = {
-    extends: join16(projectRoot, baseConfigFile),
+    extends: join18(projectRoot, baseConfigFile),
     files: absoluteFiles,
     include: [],
     exclude: [],
     compilerOptions: {
       noEmit: true,
-      typeRoots: [join16(projectRoot, "node_modules", "@types")],
+      typeRoots: [join18(projectRoot, "node_modules", "@types")],
       types: ["node"]
     }
   };
@@ -5434,7 +5461,10 @@ async function validateTypeScript(scope, typescriptScope, files, runner = defaul
     const { configPath, cleanup } = await createFileSpecificTsconfig(scope, files, deps);
     try {
       return await new Promise((resolve6) => {
-        const tscProcess = runner.spawn("npx", ["tsc", "--project", configPath], {
+        const tscBin = join18(process.cwd(), "node_modules", ".bin", "tsc");
+        const tscBinary = existsSync6(tscBin) ? tscBin : "npx";
+        const tscArgs2 = tscBinary === "npx" ? ["tsc", "--project", configPath] : ["--project", configPath];
+        const tscProcess = runner.spawn(tscBinary, tscArgs2, {
           cwd: process.cwd(),
           stdio: "inherit"
         });
@@ -5457,8 +5487,10 @@ async function validateTypeScript(scope, typescriptScope, files, runner = defaul
       return { success: false, error: `Failed to create temporary config: ${errorMessage}` };
     }
   } else {
-    tool = "npx";
-    tscArgs = buildTypeScriptArgs({ scope, configFile });
+    const tscBin = join18(process.cwd(), "node_modules", ".bin", "tsc");
+    tool = existsSync6(tscBin) ? tscBin : "npx";
+    const rawArgs = buildTypeScriptArgs({ scope, configFile });
+    tscArgs = tool === "npx" ? rawArgs : rawArgs.slice(1);
   }
   return new Promise((resolve6) => {
     const tscProcess = runner.spawn(tool, tscArgs, {