spine-framework 0.3.145 → 0.4.0

package/.framework/cli/commands/init.ts

@@ -1,257 +1,163 @@
-
-
-
-// CIL[BEGIN chunk_id="init_moduleheader_1784069813" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Module imports and constants for init command"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide filesystem utilities and path constants"]
-// CIL[DOC-CONTEXT module="cli.commands.init" layer="cli" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="constants" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports Node.js fs, path modules and defines package/project root paths" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/cli/commands/init.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/cli/commands/init.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Scaffold a new Spine Framework project into a directory"]
+// CIL[DOC-RESPONSIBILITY responsibility="Copy the framework-owned file set from .framework/templates/project.json, generate package.json/package-lock.json/.gitignore/netlify.toml/spine.config.json, and write the frozen .spine-manifest.json with framework_version"]
+// CIL[DOC-CONTEXT module="cli" layer="framework" related_files=".framework/templates/project.json,.framework/cli/lib/project-files.ts,.framework/cli/commands/upgrade.ts"]
+// CIL[DOC-CONTRACT inputs="[dir] (default cwd); spine-framework package on disk" outputs="project tree + frozen manifest" errors="exit 1 on existing .framework or missing package files" side_effects="writes <dir> only; no npm install, network, or DB access"]
+// CIL[DOC-MICRO logic_summary="Framework-only scaffold — apps install themselves via their own installer (e.g. npx <app> install). netlify.toml carries only framework blocks; apps append their own custom_* sections. package.json gets the framework's full dep set inlined plus an exact spine-framework pin so `spine-framework upgrade` can re-sync this copy" notable_decisions="never writes .env (secrets) — prints instructions to copy .env.example; existing files are never overwritten except generated package.json/netlify.toml which merge"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.9" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="installer"]
-// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import type { Command } from 'commander'
-import { existsSync, mkdirSync, writeFileSync, copyFileSync, readdirSync, statSync, cpSync, readFileSync } from 'fs'
-import { resolve, dirname, join } from 'path'
+import { existsSync, mkdirSync, writeFileSync, copyFileSync, readFileSync, readdirSync } from 'fs'
+import { resolve, dirname, join, basename } from 'path'
 import { fileURLToPath } from 'url'
-import { execSync } from 'child_process'
-
+import {
+  loadProjectProfile,
+  collectFrameworkFiles,
+  copyCollectedFiles,
+  renderNetlifyToml,
+  renderGitignore,
+  mergePackageJson,
+  writeFrozenManifest,
+  sanitizePackageName,
+} from '../lib/project-files.ts'
+// CIL[END stable_id="~/.framework/cli/commands/init.ts:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/init.ts:paths:block" type="block" identity="paths" parent="~/.framework/cli/commands/init.ts"]
+// CIL[DOC-MACRO purpose="ESM __filename/__dirname shim plus PACKAGE_ROOT — the spine-framework package root this init copies files from"]
+// CIL[DOC-CONTEXT module="cli" layer="framework" related_files="package.json"]
+// CIL[DOC-CONTRACT inputs="none" outputs="resolved path constants" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="PACKAGE_ROOT resolves three levels up from commands/ — inside the vendored package payload" notable_decisions="computed at module load from import.meta.url, not cwd"]
+// CIL[DOC-CONFIDENCE pass="first" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer"]
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
 
 const PACKAGE_ROOT = resolve(__dirname, '../../../')
-const PROJECT_ROOT = process.cwd()
-// CIL[END chunk_id="init_moduleheader_1784069813"]
-// CIL[BEGIN chunk_id="init_registerinitcommands_1784069813" type="function" identity="registerInitCommands" parent="none"]
-// CIL[DOC-MACRO purpose="Register init command with CLI program"]
-// CIL[DOC-RESPONSIBILITY responsibility="Scaffold new Spine Framework projects"]
-// CIL[DOC-CONTEXT module="cli.commands.init" layer="cli" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CLI command registration" errors="init failures" side_effects="filesystem writes"]
-// CIL[DOC-MICRO logic_summary="Copies framework files, creates directories, writes package.json and config files" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[END stable_id="~/.framework/cli/commands/init.ts:paths:block"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/init.ts:registerInitCommands:function" type="function" identity="registerInitCommands" parent="~/.framework/cli/commands/init.ts"]
+// CIL[DOC-MACRO purpose="Register the `init [dir]` command that scaffolds a neutral framework-only project"]
+// CIL[DOC-CONTEXT module="cli" layer="framework" related_files=".framework/cli/index.ts,.framework/cli/lib/project-files.ts"]
+// CIL[DOC-CONTRACT inputs="program: Command; [dir] positional (default cwd)" outputs="project tree + frozen manifest" errors="exit 1 on existing .framework or template missing" side_effects="writes <dir> only"]
+// CIL[DOC-MICRO logic_summary="Copies the profile fileset, creates the custom/ workspace, merges package.json with inlined framework deps + exact pin, writes lockfile/gitignore/netlify.toml/neutral spine.config.json, then freezes .spine-manifest.json" notable_decisions="framework-only by design — apps self-install afterwards via their own CLIs"]
+// CIL[DOC-CONFIDENCE pass="first" score="0.9" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .framework/migrations/015_simplify_apps_table.sql, .framework/src/components/ui/table-primitives.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="developer"]
 export function registerInitCommands(program: Command) {
   program
     .command('init')
-    .description('Scaffold a new Spine Framework project in the current directory')
-    .option('--force', 'Overwrite existing files', false)
-    .action(async (opts) => {
-      console.log('\nInitializing Spine Framework project...\n')
-
-      
-      const existingPkg = join(PROJECT_ROOT, 'package.json')
-      if (existsSync(existingPkg) && !opts.force) {
-        try {
-          const pkg = JSON.parse(readFileSync(existingPkg, 'utf8'))
-          const hasSpine = pkg.dependencies?.['spine-framework'] || pkg.devDependencies?.['spine-framework']
-          const hasFramework = existsSync(join(PROJECT_ROOT, '.framework'))
-          if (!hasSpine && !hasFramework && pkg.name !== 'spine-framework') {
-            console.warn('Warning: package.json exists but does not appear to be a Spine project.')
-            console.warn('Use --force to overwrite. Continuing with scaffold...\n')
-          }
-        } catch {}
-      }
+    .description('Scaffold a new Spine Framework project')
+    .argument('[dir]', 'Target directory (default: current directory)')
+    .action(async (dirArg?: string) => {
+      const target = resolve(dirArg ?? process.cwd())
+      console.log(`\nInitializing Spine Framework project in ${target}\n`)
 
       try {
-        
-        console.log('  Copying .framework/...')
-        const fwSrc = join(PACKAGE_ROOT, '.framework')
-        const fwDest = join(PROJECT_ROOT, '.framework')
-        if (!existsSync(fwDest)) {
-          cpSync(fwSrc, fwDest, { recursive: true })
-          console.log('  ✓ .framework/ copied')
-        } else {
-          console.log('  ○ .framework/ already exists, skipping')
+        if (existsSync(join(target, '.framework'))) {
+          console.error('❌ .framework/ already exists — this looks like a Spine project.')
+          console.error('   To update the framework, use: npx spine-framework upgrade')
+          process.exit(1)
         }
+        mkdirSync(target, { recursive: true })
 
-        
-        console.log('  Creating custom/ workspace...')
-        const customDirs = [
-          'custom/apps',
-          'custom/functions',
-          'custom/components',
-          'custom/migrations',
-          'custom/tests',
-        ]
-        for (const dir of customDirs) {
-          const full = join(PROJECT_ROOT, dir)
-          if (!existsSync(full)) {
-            mkdirSync(full, { recursive: true })
-          }
-        }
-        
-        const devinSrc = join(PACKAGE_ROOT, 'custom/.devin')
-        const devinDest = join(PROJECT_ROOT, 'custom/.devin')
-        if (existsSync(devinSrc) && !existsSync(devinDest)) {
-          cpSync(devinSrc, devinDest, { recursive: true })
-        }
-        console.log('  ✓ custom/ workspace created')
+        const profile = loadProjectProfile(PACKAGE_ROOT)
+        const frameworkVersion = getPackageVersion()
+        const packageName = sanitizePackageName(basename(target))
 
-        
-        console.log('  Copying config files...')
-        const configSrc = join(PACKAGE_ROOT, 'config')
-        const configDest = join(PROJECT_ROOT, 'config')
-        if (existsSync(configSrc) && !existsSync(configDest)) {
-          cpSync(configSrc, configDest, { recursive: true })
-          console.log('  ✓ config/ copied')
-        }
+        // 1. Framework-owned files (same relative layout in the package and the project)
+        console.log('  Copying framework files...')
+        const files = collectFrameworkFiles(PACKAGE_ROOT, profile)
+        copyCollectedFiles(files, target)
+        console.log(`  ✓ ${files.length} files copied`)
 
-        
-        console.log('  Copying scripts/...')
-        const scriptsSrc = join(PACKAGE_ROOT, 'scripts')
-        const scriptsDest = join(PROJECT_ROOT, 'scripts')
-        if (existsSync(scriptsSrc) && !existsSync(scriptsDest)) {
-          cpSync(scriptsSrc, scriptsDest, { recursive: true })
-          console.log('  ✓ scripts/ copied')
+        // 2. App workspace skeleton — apps own everything under custom/
+        for (const dir of ['custom/apps', 'custom/functions', 'custom/components', 'custom/migrations', 'custom/tests']) {
+          mkdirSync(join(target, dir), { recursive: true })
         }
+        console.log('  ✓ custom/ workspace created')
 
-        
-        const netlifyTomlSrc = join(PACKAGE_ROOT, 'netlify.toml')
-        if (existsSync(netlifyTomlSrc) && !existsSync(join(PROJECT_ROOT, 'netlify.toml'))) {
-          copyFileSync(netlifyTomlSrc, join(PROJECT_ROOT, 'netlify.toml'))
-          console.log('  ✓ netlify.toml copied')
+        // 3. package.json — framework deps inlined (matching the framework snapshot)
+        //    plus an exact spine-framework pin so `upgrade` can re-sync later.
+        const existingPkgPath = join(target, 'package.json')
+        let existingPkg: Record<string, any> | undefined
+        if (existsSync(existingPkgPath)) {
+          try { existingPkg = JSON.parse(readFileSync(existingPkgPath, 'utf8')) } catch {}
         }
+        const srcPkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'))
+        const merged = mergePackageJson({
+          existing: existingPkg,
+          name: packageName,
+          description: 'Spine Framework project',
+          scripts: profile.package_scripts,
+          newDependencies: srcPkg.dependencies ?? {},
+          newDevDependencies: srcPkg.devDependencies ?? {},
+          spineVersion: frameworkVersion,
+        })
+        writeFileSync(existingPkgPath, merged.text)
+        console.log('  ✓ package.json written')
 
-        
-        const spineConfigSrc = join(PACKAGE_ROOT, 'spine.config.json')
-        const spineConfigDest = join(PROJECT_ROOT, 'spine.config.json')
-        if (existsSync(spineConfigSrc) && !existsSync(spineConfigDest)) {
-          copyFileSync(spineConfigSrc, spineConfigDest)
-          console.log('  ✓ spine.config.json copied')
-        } else if (existsSync(spineConfigDest) && !JSON.parse(readFileSync(spineConfigDest, 'utf8'))?.registration?.default_app_by_role) {
-          console.log('  ⚠ Existing spine.config.json does not have default_app_by_role; consider updating it')
+        // 4. package-lock.json — verified lock tree shipped under templates/project/
+        const lockTemplate = join(PACKAGE_ROOT, 'templates/project/package-lock.json')
+        if (existsSync(lockTemplate)) {
+          const lock = JSON.parse(readFileSync(lockTemplate, 'utf8'))
+          lock.name = packageName
+          if (lock.packages?.['']) lock.packages[''].name = packageName
+          writeFileSync(join(target, 'package-lock.json'), JSON.stringify(lock, null, 2) + '\n')
+          console.log('  ✓ package-lock.json written (verified dependency set)')
+        } else {
+          console.log('  ○ package-lock template not shipped — npm install will resolve deps')
         }
 
-        
-        console.log('  Writing package.json...')
-        const projectName = PROJECT_ROOT.split('/').pop() || 'my-spine-project'
-        const pkgJson = {
-          name: projectName,
-          version: '0.1.0',
-          private: true,
-          type: 'module',
-          scripts: {
-            dev: 'netlify dev',
-            assemble: 'bash scripts/assemble.sh',
-            'assemble:frontend': 'bash scripts/assemble-frontend.sh',
-            'assemble:functions': 'bash scripts/assemble-functions.sh',
-            build: 'npm run assemble && vite build --config config/vite.config.ts',
-            verify: 'bash scripts/verify-integrity.sh',
-            test: 'vitest run',
-          },
-          dependencies: {
-            'spine-framework': `^${getPackageVersion()}`,
-          },
-          devDependencies: {
-            '@netlify/functions': '^2.8.2',
-            '@supabase/supabase-js': '^2.49.1',
-            '@tailwindcss/typography': '^0.5.19',
-            '@types/node': '^22.12.0',
-            '@types/react': '^18.3.18',
-            '@types/react-dom': '^18.3.5',
-            '@vitejs/plugin-react': '^4.3.4',
-            'autoprefixer': '^10.4.20',
-            'postcss': '^8.5.1',
-            'tailwindcss': '^3.4.17',
-            'tsx': '^4.21.0',
-            'typescript': '~5.6.2',
-            'vite': '^6.0.11',
-            'vitest': '^2.1.9',
-          },
-        }
-        
-        let finalPkg = pkgJson
-        if (existsSync(join(PROJECT_ROOT, 'package.json'))) {
-          try {
-            const existing = JSON.parse(readFileSync(join(PROJECT_ROOT, 'package.json'), 'utf8'))
-            finalPkg = {
-              ...pkgJson,
-              name: existing.name || pkgJson.name,
-              version: existing.version || pkgJson.version,
-              
-              dependencies: { ...existing.dependencies, ...pkgJson.dependencies },
-              
-              devDependencies: { ...pkgJson.devDependencies, ...existing.devDependencies },
-            }
-          } catch {}
+        // 5. .gitignore — from packed template; .env.example stays tracked
+        const gitignoreTemplate = join(PACKAGE_ROOT, 'templates/project/gitignore')
+        const gitignoreDest = join(target, '.gitignore')
+        if (!existsSync(gitignoreDest) && existsSync(gitignoreTemplate)) {
+          writeFileSync(gitignoreDest, renderGitignore(readFileSync(gitignoreTemplate, 'utf8')))
+          console.log('  ✓ .gitignore written')
+        } else if (existsSync(gitignoreDest)) {
+          console.log('  ○ .gitignore already exists, skipping')
         }
-        writeFileSync(
-          join(PROJECT_ROOT, 'package.json'),
-          JSON.stringify(finalPkg, null, 2) + '\n'
-        )
-        console.log('  ✓ package.json written')
 
-        
-        console.log('  Writing .env template...')
-        if (!existsSync(join(PROJECT_ROOT, '.env'))) {
-          const envTemplate = [
-            '# Supabase credentials',
-            '# Get these from: Supabase Dashboard → Your Project → Settings → API',
-            '# Replace the values below — do not leave them blank or as placeholders',
-            'SUPABASE_URL=',
-            'SUPABASE_ANON_KEY=',
-            'SUPABASE_SERVICE_ROLE_KEY=',
-            'SUPABASE_DB_PASSWORD=',
-            '',
-            '# Vite (browser-safe) — copy from above',
-            'VITE_SUPABASE_URL=',
-            'VITE_SUPABASE_ANON_KEY=',
-            'VITE_DB_SCHEMA=public',
-            'VITE_APP_NAME=Spine',
-            '',
-          ].join('\n')
-          writeFileSync(join(PROJECT_ROOT, '.env'), envTemplate)
-          console.log('  ✓ .env template written')
-        } else {
-          console.log('  ○ .env already exists, skipping')
+        // 6. netlify.toml — framework blocks only; preserves any existing custom_* sections
+        const netlifySrc = join(PACKAGE_ROOT, 'netlify.toml')
+        const netlifyDest = join(target, 'netlify.toml')
+        const existingToml = existsSync(netlifyDest) ? readFileSync(netlifyDest, 'utf8') : undefined
+        if (existsSync(netlifySrc)) {
+          writeFileSync(netlifyDest, renderNetlifyToml(readFileSync(netlifySrc, 'utf8'), existingToml))
+          console.log('  ✓ netlify.toml written')
         }
 
-        
-        if (!existsSync(join(PROJECT_ROOT, '.gitignore'))) {
-          const gitignore = [
-            'node_modules',
-            'dist',
-            '.assembled/',
-            '.netlify',
-            '.env',
-            '.env.local',
-            '.env.production',
-            '*.log',
-            '.DS_Store',
-            '*.tsbuildinfo',
-            '.vite',
-          ].join('\n') + '\n'
-          writeFileSync(join(PROJECT_ROOT, '.gitignore'), gitignore)
-          console.log('  ✓ .gitignore written')
+        // 7. spine.config.json — neutral template; apps register themselves at install
+        const spineConfigSrc = join(PACKAGE_ROOT, '.framework', 'templates', 'spine.config.neutral.json')
+        const spineConfigDest = join(target, 'spine.config.json')
+        if (existsSync(spineConfigSrc) && !existsSync(spineConfigDest)) {
+          copyFileSync(spineConfigSrc, spineConfigDest)
+          console.log('  ✓ spine.config.json written (neutral template)')
         }
 
-        
-        let pkgVersion = 'unknown'
-        try {
-          const pkgJson = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'))
-          pkgVersion = pkgJson.version ?? 'unknown'
-        } catch { /* non-fatal */ }
+        // 8. Frozen integrity manifest — version + framework-owned dep inventory
+        const manifest = writeFrozenManifest({
+          projectRoot: target,
+          frameworkVersion,
+          frameworkDeps: merged.frameworkDeps,
+        })
+        console.log(`  ✓ .spine-manifest.json written (${manifest.fileCount} protected files, frozen)`)
 
-        console.log(`\n✅ Project initialized! (spine-framework@${pkgVersion})\n`)
+        console.log(`\n✅ Spine Framework ${frameworkVersion} project initialized\n`)
         console.log('Next steps:')
-        console.log('  1. Edit .env with your Supabase credentials')
-        console.log('  2. Run: npm install   (installs vite, typescript, and other dev tools)')
-        console.log('  3. Run: npx spine-framework migrate')
-        console.log('  4. Run: npm run assemble && netlify dev')
+        if (!existsSync(join(target, '.env'))) {
+          console.log('  1. cp .env.example .env  — fill in your Supabase credentials')
+        } else {
+          console.log('  1. Verify .env contains your Supabase credentials')
+        }
+        console.log('  2. npm install')
+        console.log('  3. npm run verify')
+        console.log('  4. Install an app, e.g.: npx <app-package> install')
+        console.log('  5. npx spine-framework migrate')
+        console.log('  6. npm run dev:netlify')
         console.log()
-
       } catch (err: any) {
         console.error('\n❌ Init failed:', err.message)
         if (process.env.SPINE_CLI_DEBUG) console.error(err.stack)
@@ -259,29 +165,22 @@ export function registerInitCommands(program: Command) {
       }
     })
 }
-// CIL[END chunk_id="init_registerinitcommands_1784069813"]
-// CIL[BEGIN chunk_id="init_getpackageversion_1784069813" type="function" identity="getPackageVersion" parent="none"]
-// CIL[DOC-MACRO purpose="Get package version from package.json"]
-// CIL[DOC-RESPONSIBILITY responsibility="Read and return framework version"]
-// CIL[DOC-CONTEXT module="cli.commands.init" layer="cli" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="version string" errors="file read errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Reads package.json and returns version with fallback to 0.3.0" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[END stable_id="~/.framework/cli/commands/init.ts:registerInitCommands:function"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/init.ts:getPackageVersion:function" type="function" identity="getPackageVersion" parent="~/.framework/cli/commands/init.ts"]
+// CIL[DOC-MACRO purpose="Read the running package's version — becomes the project's frozen framework_version"]
+// CIL[DOC-CONTEXT module="cli" layer="framework" related_files="package.json"]
+// CIL[DOC-CONTRACT inputs="none" outputs="semver string" errors="returns '0.0.0' when package.json unreadable" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Reads PACKAGE_ROOT/package.json — the vendored CLI always ships its own manifest" notable_decisions="0.0.0 fallback is defensive only"]
+// CIL[DOC-CONFIDENCE pass="first" score="0.95" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="developer"]
 function getPackageVersion(): string {
   try {
-    const pkg = JSON.parse(
-      readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8')
-    )
-    return pkg.version || '0.3.0'
+    const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'))
+    return pkg.version || '0.0.0'
   } catch {
-    return '0.3.0'
+    return '0.0.0'
   }
 }
-// CIL[END chunk_id="init_getpackageversion_1784069813"]
+// CIL[END stable_id="~/.framework/cli/commands/init.ts:getPackageVersion:function"]