sofia-cli 0.1.1 → 0.1.4

package/dist/infra/infra/teardown.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+# ──────────────────────────────────────────────────────────────────────────────
+# teardown.sh — Remove Azure AI Foundry resources deployed by deploy.sh
+#
+# Deletes the specified resource group and all contained resources.
+# Clean exit (0) when the resource group doesn't exist.
+#
+# Usage:
+#   ./infra/teardown.sh --resource-group <name> [--yes]
+#
+# Exit codes:
+#   0 — Teardown succeeded or resource group doesn't exist
+#   1 — Prerequisite check failed
+#   2 — Deletion failed
+# ──────────────────────────────────────────────────────────────────────────────
+set -euo pipefail
+
+# ── Defaults ──────────────────────────────────────────────────────────────────
+
+RESOURCE_GROUP=""
+AUTO_CONFIRM=false
+
+# ── Parameter parsing ─────────────────────────────────────────────────────────
+
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Required:
+  -g, --resource-group <name>   Resource group to delete
+
+Optional:
+  --yes                         Skip confirmation prompt
+  -h, --help                    Show this help message
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -g|--resource-group)
+      RESOURCE_GROUP="$2"; shift 2 ;;
+    --yes)
+      AUTO_CONFIRM=true; shift ;;
+    -h|--help)
+      usage; exit 0 ;;
+    *)
+      echo "❌ Unknown option: $1" >&2
+      usage >&2
+      exit 1 ;;
+  esac
+done
+
+# ── Validate required parameters ─────────────────────────────────────────────
+
+if [[ -z "$RESOURCE_GROUP" ]]; then
+  echo "❌ Missing required parameter: --resource-group (-g)" >&2
+  usage >&2
+  exit 1
+fi
+
+# ── Prerequisite checks ──────────────────────────────────────────────────────
+
+echo "🔍 Checking prerequisites..."
+
+if ! command -v az &>/dev/null; then
+  echo "❌ Azure CLI (az) is not installed." >&2
+  echo "   Install: https://learn.microsoft.com/en-us/cli/azure/install-azure-cli" >&2
+  exit 1
+fi
+
+if ! az account show &>/dev/null; then
+  echo "❌ Not logged in to Azure. Run 'az login' first." >&2
+  exit 1
+fi
+
+echo "✅ Prerequisites passed"
+
+# ── Check if resource group exists ────────────────────────────────────────────
+
+echo ""
+echo "🔍 Checking resource group: $RESOURCE_GROUP"
+
+RG_EXISTS=$(az group exists --name "$RESOURCE_GROUP" 2>/dev/null || echo "false")
+
+if [[ "$RG_EXISTS" != "true" ]]; then
+  echo "ℹ️  Resource group '$RESOURCE_GROUP' does not exist. Nothing to delete."
+  exit 0
+fi
+
+# ── Confirm deletion ─────────────────────────────────────────────────────────
+
+if [[ "$AUTO_CONFIRM" != "true" ]]; then
+  echo ""
+  echo "⚠️  This will delete resource group '$RESOURCE_GROUP' and ALL its resources."
+  read -rp "Are you sure? (y/N): " confirm
+  if [[ "$confirm" != "y" && "$confirm" != "Y" ]]; then
+    echo "Cancelled."
+    exit 0
+  fi
+fi
+
+# ── Delete resource group ────────────────────────────────────────────────────
+
+echo ""
+echo "🗑️  Deleting resource group: $RESOURCE_GROUP"
+
+if ! az group delete --name "$RESOURCE_GROUP" --yes --no-wait; then
+  echo "" >&2
+  echo "❌ Failed to delete resource group '$RESOURCE_GROUP'." >&2
+  exit 2
+fi
+
+echo "✅ Resource group '$RESOURCE_GROUP' deletion initiated (non-blocking)."
+echo "   Resources will be fully removed within a few minutes."

package/dist/infra/main.bicep

@@ -0,0 +1,90 @@
+// ──────────────────────────────────────────────────────────────────────────────
+// Azure AI Foundry — Basic Agent Setup with Web Search
+//
+// Provisions:
+//   1. Resource Group (auto-created)
+//   2. AI Services account (Foundry) with project management enabled
+//   3. Model deployment (default: gpt-4.1-mini, GlobalStandard SKU)
+//   4. Foundry project (provides the endpoint URL)
+//   5. Account-level capability host (Agents)
+//   6. Project-level capability host (Agents, basic/Microsoft-managed)
+//
+// Usage:
+//   az deployment sub create --location <region> --template-file main.bicep \
+//     --parameters main.bicepparam
+//
+// See: specs/005-ai-search-deploy/research.md (R1, R2)
+// ──────────────────────────────────────────────────────────────────────────────
+
+targetScope = 'subscription'
+
+// ── Parameters ───────────────────────────────────────────────────────────────
+
+@description('Azure region for all resources. Must support Azure AI Foundry Agent Service.')
+param location string = 'swedencentral'
+
+@description('Name of the resource group to create or use.')
+param resourceGroupName string
+
+@description('Name of the Azure AI Services (Foundry) account. Used to derive the custom subdomain.')
+param accountName string = 'sofia-foundry'
+
+@description('Name of the Foundry project. Provides the endpoint URL for the sofIA CLI.')
+param projectName string = 'sofia-project'
+
+@description('Name of the model deployment. Used as FOUNDRY_MODEL_DEPLOYMENT_NAME env var.')
+param modelDeploymentName string = 'gpt-4.1-mini'
+
+@description('Model name to deploy. Must support web_search_preview tool type.')
+param modelName string = 'gpt-4.1-mini'
+
+@description('Model version to deploy. Pinned for reproducibility.')
+param modelVersion string = '2025-04-14'
+
+@description('SKU name for the model deployment. GlobalStandard provides broadest region availability.')
+param modelSkuName string = 'GlobalStandard'
+
+@description('SKU capacity (TPM in thousands). Default value=5000.')
+param modelSkuCapacity int = 5000
+
+@description('Object ID of the user principal to grant Azure AI Developer access. Obtain with: az ad signed-in-user show --query id -o tsv')
+param userPrincipalId string
+
+// ── Unique suffix for globally unique names ──────────────────────────────────
+
+var uniqueSuffix = uniqueString(subscription().subscriptionId, resourceGroupName)
+
+// ── Resource Group ───────────────────────────────────────────────────────────
+
+// Auto-create the resource group if it doesn't exist (FR-002)
+resource rg 'Microsoft.Resources/resourceGroups@2024-03-01' = {
+  name: resourceGroupName
+  location: location
+}
+
+// ── Module: all resources deployed into the resource group ───────────────────
+
+module resources 'resources.bicep' = {
+  name: 'foundry-resources'
+  scope: rg
+  params: {
+    location: location
+    accountName: accountName
+    projectName: projectName
+    modelDeploymentName: modelDeploymentName
+    modelName: modelName
+    modelVersion: modelVersion
+    modelSkuName: modelSkuName
+    modelSkuCapacity: modelSkuCapacity
+    uniqueSuffix: uniqueSuffix
+    userPrincipalId: userPrincipalId
+  }
+}
+
+// ── Outputs ──────────────────────────────────────────────────────────────────
+
+@description('Foundry project endpoint URL — set as FOUNDRY_PROJECT_ENDPOINT')
+output projectEndpoint string = resources.outputs.projectEndpoint
+
+@description('Model deployment name — set as FOUNDRY_MODEL_DEPLOYMENT_NAME')
+output modelDeploymentName string = modelDeploymentName

package/dist/infra/main.bicepparam

@@ -0,0 +1,18 @@
+using 'main.bicep'
+
+// ── Default parameters for workshop/PoC deployment ───────────────────────────
+// Override at deploy time via:
+//   az deployment sub create --parameters resourceGroupName='my-rg' location='eastus'
+
+param resourceGroupName = 'sofia-rg'
+param location = 'swedencentral'
+param accountName = 'sofia-foundry'
+param projectName = 'sofia-project'
+param modelDeploymentName = 'gpt-4.1-mini'
+param modelName = 'gpt-4.1-mini'
+param modelVersion = '2025-04-14'
+param modelSkuName = 'GlobalStandard'
+param modelSkuCapacity = 1
+
+// Resolved at deploy time by deploy.sh via: az ad signed-in-user show --query id -o tsv
+param userPrincipalId = ''

package/dist/infra/resources.bicep

@@ -0,0 +1,134 @@
+// ──────────────────────────────────────────────────────────────────────────────
+// Resource-group-scoped resources for Azure AI Foundry
+//
+// Deployed as a module from main.bicep (subscription-scoped).
+// ──────────────────────────────────────────────────────────────────────────────
+
+// ── Parameters (passed from main.bicep) ──────────────────────────────────────
+
+param location string
+param accountName string
+param projectName string
+param modelDeploymentName string
+param modelName string
+param modelVersion string
+param modelSkuName string
+param modelSkuCapacity int
+param uniqueSuffix string
+
+@description('Object ID of the user principal to grant Azure AI Developer access. Obtain with: az ad signed-in-user show --query id -o tsv')
+param userPrincipalId string
+
+// ── Derived values ───────────────────────────────────────────────────────────
+
+var customSubDomainName = '${accountName}-${uniqueSuffix}'
+
+// Azure AI Developer — allows creating/managing agents and using models
+// https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#azure-ai-developer
+var azureAIDeveloperRoleId = subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '64702f94-c441-49e6-a78b-ef80e0188fee')
+
+// ── Resource 1: AI Services Account (Foundry) ────────────────────────────────
+// Top-level Foundry account with project management enabled.
+// kind: AIServices provides access to Foundry Agent Service capabilities.
+
+resource aiAccount 'Microsoft.CognitiveServices/accounts@2025-06-01' = {
+  name: accountName
+  location: location
+  kind: 'AIServices'
+  identity: {
+    type: 'SystemAssigned'
+  }
+  sku: {
+    name: 'S0'
+  }
+  properties: {
+    customSubDomainName: customSubDomainName
+    allowProjectManagement: true
+    publicNetworkAccess: 'Enabled'
+  }
+}
+
+// ── Resource 2: Model Deployment ─────────────────────────────────────────────
+// Deploys the language model that will process web search queries.
+// Default: gpt-4.1-mini with GlobalStandard SKU for broadest availability.
+
+resource modelDeploy 'Microsoft.CognitiveServices/accounts/deployments@2025-06-01' = {
+  parent: aiAccount
+  name: modelDeploymentName
+  sku: {
+    name: modelSkuName
+    capacity: modelSkuCapacity
+  }
+  properties: {
+    model: {
+      format: 'OpenAI'
+      name: modelName
+      version: modelVersion
+    }
+  }
+}
+
+// ── Resource 3: Foundry Project ──────────────────────────────────────────────
+// Provides the endpoint URL used by the sofIA CLI (FOUNDRY_PROJECT_ENDPOINT).
+
+resource project 'Microsoft.CognitiveServices/accounts/projects@2025-06-01' = {
+  parent: aiAccount
+  name: projectName
+  location: location
+  identity: {
+    type: 'SystemAssigned'
+  }
+  properties: {}
+  dependsOn: [
+    modelDeploy
+  ]
+}
+
+// ── Resource 4: Account Capability Host (Agents) ─────────────────────────────
+// Enables the Agent Service at the account level.
+// Must be created before the project capability host.
+
+resource accountCapabilityHost 'Microsoft.CognitiveServices/accounts/capabilityHosts@2025-06-01' = {
+  parent: aiAccount
+  name: 'default'
+  properties: {
+    capabilityHostKind: 'Agents'
+  }
+  dependsOn: [
+    project
+    modelDeploy
+  ]
+}
+
+// ── Resource 5: Project Capability Host (Agents) ─────────────────────────────
+// Enables the Agent Service at the project level.
+// Basic (Microsoft-managed) setup — empty connections array.
+
+resource projectCapabilityHost 'Microsoft.CognitiveServices/accounts/projects/capabilityHosts@2025-06-01' = {
+  parent: project
+  name: 'default'
+  properties: {
+    capabilityHostKind: 'Agents'
+  }
+  dependsOn: [
+    accountCapabilityHost
+  ]
+}
+
+// ── Resource 6: Role Assignment — Azure AI Developer for the deploying user ──
+// Grants the deploying user permission to create ephemeral agents, use models,
+// and invoke web_search_preview through the Foundry Agent Service.
+
+resource roleAssignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
+  name: guid(aiAccount.id, userPrincipalId, azureAIDeveloperRoleId)
+  scope: aiAccount
+  properties: {
+    principalId: userPrincipalId
+    roleDefinitionId: azureAIDeveloperRoleId
+    principalType: 'User'
+  }
+}
+
+// ── Outputs ──────────────────────────────────────────────────────────────────
+
+output projectEndpoint string = project.properties.endpoints['AI Foundry API']

package/dist/infra/teardown.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+# ──────────────────────────────────────────────────────────────────────────────
+# teardown.sh — Remove Azure AI Foundry resources deployed by deploy.sh
+#
+# Deletes the specified resource group and all contained resources.
+# Clean exit (0) when the resource group doesn't exist.
+#
+# Usage:
+#   ./infra/teardown.sh --resource-group <name> [--yes]
+#
+# Exit codes:
+#   0 — Teardown succeeded or resource group doesn't exist
+#   1 — Prerequisite check failed
+#   2 — Deletion failed
+# ──────────────────────────────────────────────────────────────────────────────
+set -euo pipefail
+
+# ── Defaults ──────────────────────────────────────────────────────────────────
+
+RESOURCE_GROUP=""
+AUTO_CONFIRM=false
+
+# ── Parameter parsing ─────────────────────────────────────────────────────────
+
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Required:
+  -g, --resource-group <name>   Resource group to delete
+
+Optional:
+  --yes                         Skip confirmation prompt
+  -h, --help                    Show this help message
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -g|--resource-group)
+      RESOURCE_GROUP="$2"; shift 2 ;;
+    --yes)
+      AUTO_CONFIRM=true; shift ;;
+    -h|--help)
+      usage; exit 0 ;;
+    *)
+      echo "❌ Unknown option: $1" >&2
+      usage >&2
+      exit 1 ;;
+  esac
+done
+
+# ── Validate required parameters ─────────────────────────────────────────────
+
+if [[ -z "$RESOURCE_GROUP" ]]; then
+  echo "❌ Missing required parameter: --resource-group (-g)" >&2
+  usage >&2
+  exit 1
+fi
+
+# ── Prerequisite checks ──────────────────────────────────────────────────────
+
+echo "🔍 Checking prerequisites..."
+
+if ! command -v az &>/dev/null; then
+  echo "❌ Azure CLI (az) is not installed." >&2
+  echo "   Install: https://learn.microsoft.com/en-us/cli/azure/install-azure-cli" >&2
+  exit 1
+fi
+
+if ! az account show &>/dev/null; then
+  echo "❌ Not logged in to Azure. Run 'az login' first." >&2
+  exit 1
+fi
+
+echo "✅ Prerequisites passed"
+
+# ── Check if resource group exists ────────────────────────────────────────────
+
+echo ""
+echo "🔍 Checking resource group: $RESOURCE_GROUP"
+
+RG_EXISTS=$(az group exists --name "$RESOURCE_GROUP" 2>/dev/null || echo "false")
+
+if [[ "$RG_EXISTS" != "true" ]]; then
+  echo "ℹ️  Resource group '$RESOURCE_GROUP' does not exist. Nothing to delete."
+  exit 0
+fi
+
+# ── Confirm deletion ─────────────────────────────────────────────────────────
+
+if [[ "$AUTO_CONFIRM" != "true" ]]; then
+  echo ""
+  echo "⚠️  This will delete resource group '$RESOURCE_GROUP' and ALL its resources."
+  read -rp "Are you sure? (y/N): " confirm
+  if [[ "$confirm" != "y" && "$confirm" != "Y" ]]; then
+    echo "Cancelled."
+    exit 0
+  fi
+fi
+
+# ── Delete resource group ────────────────────────────────────────────────────
+
+echo ""
+echo "🗑️  Deleting resource group: $RESOURCE_GROUP"
+
+if ! az group delete --name "$RESOURCE_GROUP" --yes --no-wait; then
+  echo "" >&2
+  echo "❌ Failed to delete resource group '$RESOURCE_GROUP'." >&2
+  exit 2
+fi
+
+echo "✅ Resource group '$RESOURCE_GROUP' deletion initiated (non-blocking)."
+echo "   Resources will be fully removed within a few minutes."

package/dist/src/cli/developCommand.js

@@ -17,7 +17,6 @@ import { RalphLoop } from '../develop/ralphLoop.js';
 import { McpContextEnricher } from '../develop/mcpContextEnricher.js';
 import { deriveCheckpointState } from '../develop/checkpointState.js';
 import { createDefaultRegistry, selectTemplate } from '../develop/templateRegistry.js';
-import { PocScaffolder } from '../develop/pocScaffolder.js';
 // ── Validation ────────────────────────────────────────────────────────────────
 /**
  * Validate that a session is ready for the Develop phase.
@@ -162,7 +161,6 @@ export async function developCommand(opts, deps) {
         outputDir,
         enricher,
         checkpoint,
-        scaffolder: new PocScaffolder(template),
         templateEntry: template,
         onSessionUpdate: async (updated) => {
             await store.save(updated);

package/dist/src/cli/index.js

@@ -8,6 +8,7 @@
  * - status: display session status
  * - export: export session artifacts
  */
+import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { Command } from 'commander';
@@ -15,6 +16,12 @@ import { loadEnvFile } from './envLoader.js';
 // ── Load .env from workspace root ──────────────────────────────────────────
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 loadEnvFile(path.resolve(__dirname, '../../.env'));
+// ── Read version from package.json (works from both src/ and dist/) ────────
+let _pkgRoot = __dirname;
+while (_pkgRoot !== path.dirname(_pkgRoot) && !existsSync(path.join(_pkgRoot, 'package.json'))) {
+    _pkgRoot = path.dirname(_pkgRoot);
+}
+const { version } = JSON.parse(readFileSync(path.join(_pkgRoot, 'package.json'), 'utf-8'));
 // ── Build CLI ──────────────────────────────────────────────────────────────
 /**
  * Build the Commander program. Accepts optional handler overrides for testing.
@@ -22,7 +29,7 @@ loadEnvFile(path.resolve(__dirname, '../../.env'));
  */
 export function buildCli(handlers) {
     const program = new Command();
-    program.name('sofia').description('sofIA — AI Discovery Workshop CLI').version('0.1.0');
+    program.name('sofia').description('sofIA — AI Discovery Workshop CLI').version(version);
     // ── Global options ──────────────────────────────────────────────────────
     program
         .option('--session <id>', 'Target an existing session')

package/dist/src/cli/workshopCommand.js

@@ -14,7 +14,7 @@ import { createDefaultStore } from '../sessions/sessionStore.js';
 import { createLoopIO } from './ioContext.js';
 import { createPhaseHandler, getPhaseOrder, getNextPhase } from '../phases/phaseHandlers.js';
 import { renderMarkdown } from '../shared/markdownRenderer.js';
-import { destroyWebSearchSession, isWebSearchConfigured, createWebSearchTool } from '../mcp/webSearch.js';
+import { destroyWebSearchSession, isWebSearchConfigured, createWebSearchTool, } from '../mcp/webSearch.js';
 import { loadEnvFile } from './envLoader.js';
 import { loadMcpConfig, McpManager } from '../mcp/mcpManager.js';
 import { RalphLoop } from '../develop/ralphLoop.js';

package/dist/src/develop/index.js

@@ -4,7 +4,7 @@
  * Exports all components of the PoC Generation & Ralph Loop feature (Feature 002).
  * Orchestrates: scaffold → install → iterate (test → fix → repeat) → complete.
  */
-export { PocScaffolder } from './pocScaffolder.js';
+export { validatePocOutput, initializeGitRepo, scanAndRecordTodos, toKebabCase, buildScaffoldContext, } from './pocUtils.js';
 export { generateDynamicScaffold } from './dynamicScaffolder.js';
 export { TestRunner } from './testRunner.js';
 export { CodeGenerator } from './codeGenerator.js';