fss-link 1.5.9 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fss-link",
-  "version": "1.5.9",
+  "version": "1.6.0",
   "engines": {
     "node": ">=20.0.0"
   },
@@ -56,6 +56,7 @@
   },
   "files": [
     "bundle/",
+    "scripts/",
     "README.md",
     "LICENSE"
   ],
@@ -147,6 +148,7 @@
     "react-dom": "19.1.1",
     "read-package-up": "^11.0.0",
     "shell-quote": "^1.8.3",
+    "sharp": "^0.34.4",
     "signal-exit": "^4.1.0",
     "simple-git": "^3.28.0",
     "sql.js": "^1.11.0",

package/scripts/analyze-session-logs.sh

@@ -0,0 +1,279 @@
+#!/bin/bash
+# FSS Link Session Log Analyzer
+# Quick analysis and searching of processed session logs
+
+set -euo pipefail
+
+# Configuration
+PROCESSED_DIR="/MASTERFOLDER/Projects/fss-link/fss-live-testing/session-logs/processed"
+ANALYSIS_DIR="/MASTERFOLDER/Projects/fss-link/fss-live-testing/session-logs/analysis"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+usage() {
+    cat << EOF
+Usage: $0 [COMMAND] [OPTIONS]
+
+Analyze FSS Link session logs for testing validation.
+
+COMMANDS:
+    stats               Show statistics for all sessions
+    search TERM         Search for specific term in sessions
+    tools TOOL          Find sessions using specific tool
+    errors              Find sessions with errors
+    summary FILE        Generate summary report for session
+
+OPTIONS:
+    -h, --help         Show this help message
+
+EXAMPLES:
+    $0 stats                          # Show all session statistics
+    $0 search "read_file"             # Find sessions mentioning read_file
+    $0 tools TodoWrite                # Find sessions using TodoWrite
+    $0 errors                         # Find sessions with errors
+    $0 summary SESSION_*.md           # Summarize specific session
+
+EOF
+    exit 1
+}
+
+# Show statistics for all processed sessions
+show_stats() {
+    echo -e "${BLUE}=== Session Log Statistics ===${NC}\n"
+
+    if [[ ! -d "${PROCESSED_DIR}" ]] || [[ -z "$(ls -A ${PROCESSED_DIR} 2>/dev/null)" ]]; then
+        echo -e "${RED}No processed sessions found in ${PROCESSED_DIR}${NC}"
+        exit 1
+    fi
+
+    local total_sessions=0
+    local total_messages=0
+    local total_tool_calls=0
+    local total_errors=0
+
+    for session in "${PROCESSED_DIR}"/*.md; do
+        if [[ ! -f "${session}" ]]; then
+            continue
+        fi
+
+        ((total_sessions++))
+
+        # Extract metadata from session file
+        messages=$(grep "^\*\*Total Messages\*\*:" "${session}" | sed 's/.*: //')
+        tool_calls=$(grep "^\*\*Tool Calls\*\*:" "${session}" | sed 's/.*: //' || echo "0")
+        errors=$(grep "^\*\*Errors\*\*:" "${session}" | sed 's/.*: //' || echo "0")
+
+        # Extract from metadata section if not in header
+        if [[ -z "${messages}" ]]; then
+            messages=$(grep '"total_messages":' "${session}" | sed 's/.*: //' | tr -d ',' || echo "0")
+        fi
+        if [[ -z "${tool_calls}" ]] || [[ "${tool_calls}" == "0" ]]; then
+            tool_calls=$(grep '"total_tool_calls":' "${session}" | sed 's/.*: //' | tr -d ',' || echo "0")
+        fi
+        if [[ -z "${errors}" ]] || [[ "${errors}" == "0" ]]; then
+            errors=$(grep '"total_errors":' "${session}" | sed 's/.*: //' | tr -d ',' || echo "0")
+        fi
+
+        total_messages=$((total_messages + messages))
+        total_tool_calls=$((total_tool_calls + tool_calls))
+        total_errors=$((total_errors + errors))
+
+        session_name=$(basename "${session}")
+        echo -e "${GREEN}${session_name}${NC}"
+        echo "  Messages: ${messages}"
+        echo "  Tool calls: ${tool_calls}"
+        echo "  Errors: ${errors}"
+        echo ""
+    done
+
+    echo -e "${YELLOW}=== Totals ===${NC}"
+    echo "Sessions analyzed: ${total_sessions}"
+    echo "Total messages: ${total_messages}"
+    echo "Total tool calls: ${total_tool_calls}"
+    echo "Total errors: ${total_errors}"
+}
+
+# Search for term in sessions
+search_term() {
+    local term="$1"
+    echo -e "${BLUE}=== Searching for: '${term}' ===${NC}\n"
+
+    for session in "${PROCESSED_DIR}"/*.md; do
+        if [[ ! -f "${session}" ]]; then
+            continue
+        fi
+
+        if grep -qi "${term}" "${session}"; then
+            session_name=$(basename "${session}")
+            count=$(grep -ci "${term}" "${session}")
+            echo -e "${GREEN}${session_name}${NC} - ${count} matches"
+
+            # Show first few matches with context
+            grep -ni "${term}" "${session}" | head -3 | while read -r line; do
+                echo "  ${line}"
+            done
+            echo ""
+        fi
+    done
+}
+
+# Find sessions using specific tool
+find_tool_usage() {
+    local tool="$1"
+    echo -e "${BLUE}=== Sessions using tool: '${tool}' ===${NC}\n"
+
+    for session in "${PROCESSED_DIR}"/*.md; do
+        if [[ ! -f "${session}" ]]; then
+            continue
+        fi
+
+        # Check in tools_used metadata or tool call sections
+        if grep -qi "\"${tool}\"" "${session}" || grep -qi "\[FUNCTION CALL: ${tool}\]" "${session}"; then
+            session_name=$(basename "${session}")
+            call_count=$(grep -ci "\[FUNCTION CALL: ${tool}\]" "${session}" || echo "0")
+
+            echo -e "${GREEN}${session_name}${NC}"
+            echo "  Tool calls: ${call_count}"
+
+            # Extract tool calls section summary if exists
+            if grep -qi "### ${tool}" "${session}"; then
+                summary=$(grep -A 1 "### ${tool}" "${session}" | tail -1)
+                echo "  ${summary}"
+            fi
+            echo ""
+        fi
+    done
+}
+
+# Find sessions with errors
+find_errors() {
+    echo -e "${BLUE}=== Sessions with Errors ===${NC}\n"
+
+    local found=0
+
+    for session in "${PROCESSED_DIR}"/*.md; do
+        if [[ ! -f "${session}" ]]; then
+            continue
+        fi
+
+        errors=$(grep '"total_errors":' "${session}" | sed 's/.*: //' | tr -d ',' || echo "0")
+
+        if [[ "${errors}" != "0" ]] && [[ -n "${errors}" ]]; then
+            ((found++))
+            session_name=$(basename "${session}")
+            echo -e "${RED}${session_name}${NC} - ${errors} errors"
+
+            # Show error section if exists
+            if grep -q "## Errors and Issues" "${session}"; then
+                grep -A 5 "## Errors and Issues" "${session}" | tail -4
+            fi
+            echo ""
+        fi
+    done
+
+    if [[ ${found} -eq 0 ]]; then
+        echo -e "${GREEN}No errors found in any session!${NC}"
+    fi
+}
+
+# Generate summary for specific session
+generate_summary() {
+    local session_file="$1"
+
+    if [[ ! -f "${session_file}" ]]; then
+        echo -e "${RED}Session file not found: ${session_file}${NC}"
+        exit 1
+    fi
+
+    session_name=$(basename "${session_file}")
+    echo -e "${BLUE}=== Summary: ${session_name} ===${NC}\n"
+
+    # Extract key metadata
+    messages=$(grep '"total_messages":' "${session_file}" | sed 's/.*: //' | tr -d ',')
+    tool_calls=$(grep '"total_tool_calls":' "${session_file}" | sed 's/.*: //' | tr -d ',')
+    errors=$(grep '"total_errors":' "${session_file}" | sed 's/.*: //' | tr -d ',')
+    session_date=$(grep '"session_date":' "${session_file}" | sed 's/.*: "//' | tr -d '",')
+
+    echo -e "${YELLOW}Basic Info:${NC}"
+    echo "  Date: ${session_date}"
+    echo "  Messages: ${messages}"
+    echo "  Tool calls: ${tool_calls}"
+    echo "  Errors: ${errors}"
+    echo ""
+
+    # Extract tools used
+    echo -e "${YELLOW}Tools Used:${NC}"
+    grep '"tools_used":' -A 12 "${session_file}" | grep '"' | sed 's/.*"//;s/".*//' | sed 's/^/  - /'
+    echo ""
+
+    # Show tool call breakdown
+    echo -e "${YELLOW}Tool Call Breakdown:${NC}"
+    grep -E "^### .* \([0-9]+ calls\)" "${session_file}" | sed 's/^###/  -/'
+    echo ""
+
+    # Check for key events
+    echo -e "${YELLOW}Key Events:${NC}"
+    if grep -q "NO NO NO" "${session_file}"; then
+        echo "  ⚠️  User correction detected"
+    fi
+    if grep -qi "TodoWrite" "${session_file}"; then
+        todo_count=$(grep -ci "todo_write" "${session_file}")
+        echo "  ✓ TodoWrite used: ${todo_count} times"
+    fi
+    if grep -qi "Production Ready" "${session_file}"; then
+        echo "  ✓ Testing completed - marked as Production Ready"
+    fi
+}
+
+# Main execution
+main() {
+    if [[ $# -eq 0 ]]; then
+        usage
+    fi
+
+    mkdir -p "${ANALYSIS_DIR}"
+
+    case "$1" in
+        stats)
+            show_stats
+            ;;
+        search)
+            if [[ $# -lt 2 ]]; then
+                echo -e "${RED}Error: search requires a term${NC}"
+                usage
+            fi
+            search_term "$2"
+            ;;
+        tools)
+            if [[ $# -lt 2 ]]; then
+                echo -e "${RED}Error: tools requires a tool name${NC}"
+                usage
+            fi
+            find_tool_usage "$2"
+            ;;
+        errors)
+            find_errors
+            ;;
+        summary)
+            if [[ $# -lt 2 ]]; then
+                echo -e "${RED}Error: summary requires a session file${NC}"
+                usage
+            fi
+            generate_summary "$2"
+            ;;
+        -h|--help)
+            usage
+            ;;
+        *)
+            echo -e "${RED}Unknown command: $1${NC}"
+            usage
+            ;;
+    esac
+}
+
+main "$@"

package/scripts/build.js

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, '..');
+
+// npm install if node_modules was removed (e.g. via npm run clean or scripts/clean.js)
+if (!existsSync(join(root, 'node_modules'))) {
+  execSync('npm install', { stdio: 'inherit', cwd: root });
+}
+
+// build all workspaces/packages
+execSync('npm run generate', { stdio: 'inherit', cwd: root });
+execSync('npm run build --workspaces', { stdio: 'inherit', cwd: root });
+
+// also build container image if sandboxing is enabled
+// skip (-s) npm install + build since we did that above
+try {
+  execSync('node scripts/sandbox_command.js -q', {
+    stdio: 'inherit',
+    cwd: root,
+  });
+  if (
+    process.env.BUILD_SANDBOX === '1' ||
+    process.env.BUILD_SANDBOX === 'true'
+  ) {
+    execSync('node scripts/build_sandbox.js -s', {
+      stdio: 'inherit',
+      cwd: root,
+    });
+  }
+} catch {
+  // ignore
+}

package/scripts/build_package.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import { execSync } from 'child_process';
+import { writeFileSync } from 'fs';
+import { join } from 'path';
+
+if (!process.cwd().includes('packages')) {
+  console.error('must be invoked from a package directory');
+  process.exit(1);
+}
+
+// build typescript files
+execSync('tsc --build', { stdio: 'inherit' });
+
+// copy .{md,json} files
+execSync('node ../../scripts/copy_files.js', { stdio: 'inherit' });
+
+// touch dist/.last_build
+writeFileSync(join(process.cwd(), 'dist', '.last_build'), '');
+process.exit(0);

package/scripts/build_sandbox.js

@@ -0,0 +1,195 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import { execSync } from 'child_process';
+import { chmodSync, existsSync, readFileSync, rmSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import os from 'os';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import cliPkgJson from '../packages/cli/package.json' with { type: 'json' };
+
+const argv = yargs(hideBin(process.argv))
+  .option('s', {
+    alias: 'skip-npm-install-build',
+    type: 'boolean',
+    default: false,
+    description: 'skip npm install + npm run build',
+  })
+  .option('f', {
+    alias: 'dockerfile',
+    type: 'string',
+    description: 'use <dockerfile> for custom image',
+  })
+  .option('i', {
+    alias: 'image',
+    type: 'string',
+    description: 'use <image> name for custom image',
+  })
+  .option('output-file', {
+    type: 'string',
+    description:
+      'Path to write the final image URI. Used for CI/CD pipeline integration.',
+  }).argv;
+
+let sandboxCommand;
+try {
+  sandboxCommand = execSync('node scripts/sandbox_command.js')
+    .toString()
+    .trim();
+} catch {
+  console.warn('ERROR: could not detect sandbox container command');
+  process.exit(0);
+}
+
+if (sandboxCommand === 'sandbox-exec') {
+  console.warn(
+    'WARNING: container-based sandboxing is disabled (see README.md#sandboxing)',
+  );
+  process.exit(0);
+}
+
+console.log(`using ${sandboxCommand} for sandboxing`);
+
+const baseImage = cliPkgJson.config.sandboxImageUri;
+const customImage = argv.i;
+const baseDockerfile = 'Dockerfile';
+const customDockerfile = argv.f;
+
+if (!baseImage?.length) {
+  console.warn(
+    'No default image tag specified in gemini-cli/packages/cli/package.json',
+  );
+}
+
+if (!argv.s) {
+  execSync('npm install', { stdio: 'inherit' });
+  execSync('npm run build --workspaces', { stdio: 'inherit' });
+}
+
+console.log('packing fss-link ...');
+const cliPackageDir = join('packages', 'cli');
+rmSync(join(cliPackageDir, 'dist', 'fss-link-*.tgz'), { force: true });
+execSync(
+  `npm pack -w fss-link --pack-destination ./packages/cli/dist`,
+  {
+    stdio: 'ignore',
+  },
+);
+
+console.log('packing fss-link-core ...');
+const corePackageDir = join('packages', 'core');
+rmSync(join(corePackageDir, 'dist', 'fss-link-core-*.tgz'), {
+  force: true,
+});
+execSync(
+  `npm pack -w fss-link-core --pack-destination ./packages/core/dist`,
+  { stdio: 'ignore' },
+);
+
+const packageVersion = JSON.parse(
+  readFileSync(join(process.cwd(), 'package.json'), 'utf-8'),
+).version;
+
+chmodSync(
+  join(cliPackageDir, 'dist', `qwen-code-qwen-code-${packageVersion}.tgz`),
+  0o755,
+);
+chmodSync(
+  join(
+    corePackageDir,
+    'dist',
+    `qwen-code-qwen-code-core-${packageVersion}.tgz`,
+  ),
+  0o755,
+);
+
+const buildStdout = process.env.VERBOSE ? 'inherit' : 'ignore';
+
+// Determine the appropriate shell based on OS
+const isWindows = os.platform() === 'win32';
+const shellToUse = isWindows ? 'powershell.exe' : '/bin/bash';
+
+function buildImage(imageName, dockerfile) {
+  console.log(`building ${imageName} ... (can be slow first time)`);
+
+  let buildCommandArgs = '';
+  let tempAuthFile = '';
+
+  if (sandboxCommand === 'podman') {
+    if (isWindows) {
+      // PowerShell doesn't support <() process substitution.
+      // Create a temporary auth file that we will clean up after.
+      tempAuthFile = join(os.tmpdir(), `qwen-auth-${Date.now()}.json`);
+      writeFileSync(tempAuthFile, '{}');
+      buildCommandArgs = `--authfile="${tempAuthFile}"`;
+    } else {
+      // Use bash-specific syntax for Linux/macOS
+      buildCommandArgs = `--authfile=<(echo '{}')`;
+    }
+  }
+
+  const npmPackageVersion = JSON.parse(
+    readFileSync(join(process.cwd(), 'package.json'), 'utf-8'),
+  ).version;
+
+  const imageTag =
+    process.env.GEMINI_SANDBOX_IMAGE_TAG || imageName.split(':')[1];
+  const finalImageName = `${imageName.split(':')[0]}:${imageTag}`;
+
+  try {
+    execSync(
+      `${sandboxCommand} build ${buildCommandArgs} ${
+        process.env.BUILD_SANDBOX_FLAGS || ''
+      } --build-arg CLI_VERSION_ARG=${npmPackageVersion} -f "${dockerfile}" -t "${imageName}" .`,
+      { stdio: buildStdout, shell: shellToUse },
+    );
+    console.log(`built ${finalImageName}`);
+
+    // If an output file path was provided via command-line, write the final image URI to it.
+    if (argv.outputFile) {
+      console.log(
+        `Writing final image URI for CI artifact to: ${argv.outputFile}`,
+      );
+      // The publish step only supports one image. If we build multiple, only the last one
+      // will be published. Throw an error to make this failure explicit if the file already exists.
+      if (existsSync(argv.outputFile)) {
+        throw new Error(
+          `CI artifact file ${argv.outputFile} already exists. Refusing to overwrite.`,
+        );
+      }
+      writeFileSync(argv.outputFile, finalImageName);
+    }
+  } finally {
+    // If we created a temp file, delete it now.
+    if (tempAuthFile) {
+      rmSync(tempAuthFile, { force: true });
+    }
+  }
+}
+
+if (baseImage && baseDockerfile) {
+  buildImage(baseImage, baseDockerfile);
+}
+
+if (customDockerfile && customImage) {
+  buildImage(customImage, customDockerfile);
+}
+
+execSync(`${sandboxCommand} image prune -f`, { stdio: 'ignore' });

package/scripts/build_vscode_companion.js

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import { execSync } from 'child_process';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, '..');
+
+execSync('npx --yes @vscode/vsce package --no-dependencies', {
+  stdio: 'inherit',
+  cwd: join(root, 'packages', 'vscode-ide-companion'),
+});