@phila/cli 0.0.1 → 0.0.3

package/README.md

@@ -0,0 +1,150 @@
+# @phila/cli
+
+CLI tool for City of Philadelphia AWS infrastructure management.
+
+## Installation
+
+```bash
+npm install -g @phila/cli
+# or
+pnpm add -g @phila/cli
+```
+
+## Usage
+
+The CLI is available as the `city` command:
+
+```bash
+city [command]
+```
+
+## Commands
+
+### `city init [appName]`
+
+Create a new Philadelphia infrastructure project from a template. If `appName` is not provided, you will be prompted for it.
+
+```bash
+# Interactive mode
+city init
+
+# With appName argument
+city init my-app
+```
+
+This command will:
+- Guide you through template selection
+- Prompt for project configuration
+- Scaffold the project structure
+- Set up initial AWS CDK infrastructure
+
+### `city deploy [environment]`
+
+Deploy the project to AWS. Supports `dev`, `test`, and `prod` environments.
+
+```bash
+city deploy dev
+city deploy prod
+```
+
+### `city ship [environment]`
+
+Ship code to AWS without full infrastructure deployment. Useful for quick code updates.
+
+```bash
+city ship dev --lambda api
+city ship dev --web
+city ship dev --ecs
+city ship dev --all  # Ship all components
+```
+
+Options:
+- `--lambda [name]` - Ship Lambda function (optionally specify name)
+- `--web` - Ship frontend to S3/CloudFront
+- `--ecs` - Ship ECS container
+- `--all` - Ship all components (default when no flags specified)
+
+### `city destroy [environment]`
+
+Open CloudFormation console to destroy a stack.
+
+```bash
+city destroy dev
+```
+
+### `city config`
+
+Manage project configuration.
+
+```bash
+city config show              # Display current configuration
+city config get <key>         # Get a specific configuration value
+city config set <key> <value> # Set a configuration value
+```
+
+### `city map`
+
+Navigate and query the codebase.
+
+```bash
+city map show                    # Show codebase map statistics
+city map where <query>           # Find files by keyword
+city map where --export <name>   # Search by export name
+city map where --layer <layer>   # Filter by layer (l1, l2, l3, cli, core, etc.)
+city map update                  # Regenerate codebase.json
+city map check                   # Validate codebase.json
+```
+
+### `city templates`
+
+List available project templates.
+
+```bash
+city templates        # List all templates in tree format
+city templates simple  # List all templates in simple format
+```
+
+## Project Structure
+
+When you run `city init`, it creates a project with:
+
+- `cdk/` - AWS CDK infrastructure code
+- `apps/` - Application code (Lambda functions, etc.)
+- `city.config.json` - Project configuration
+- `package.json` - Dependencies and scripts
+
+## Configuration
+
+Project configuration is stored in `city.config.json`. Common settings include:
+
+- AWS profile
+- Environment settings
+- Application name
+- Resource naming conventions
+
+## Requirements
+
+The CLI checks for required dependencies on startup:
+- Node.js (>=18.0.0)
+- npm or pnpm
+- AWS CLI
+- AWS CDK CLI
+
+Missing dependencies will be detected and installation instructions provided.
+
+## Development
+
+```bash
+# Build
+pnpm build
+
+# Run tests
+pnpm test
+
+# Lint
+pnpm lint
+```
+
+## License
+
+Part of the City of Philadelphia AWS Infrastructure Library.

package/dist/index.js

@@ -2,8 +2,12 @@
 "use strict";
 // ABOUTME: CLI entry point for the city command
 // ABOUTME: Provides init and deploy commands for Philadelphia infrastructure projects
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const package_json_1 = __importDefault(require("../package.json"));
 const init_1 = require("./commands/init");
 const deploy_1 = require("./commands/deploy");
 const ship_1 = require("./commands/ship");
@@ -15,7 +19,7 @@ const program = new commander_1.Command();
 program
     .name('city')
     .description('CLI for City of Philadelphia AWS infrastructure')
-    .version('1.0.0');
+    .version(package_json_1.default.version);
 program
     .command('init [appName]')
     .description('Create a new Philadelphia infrastructure project')

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phila/cli",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "CLI tool for City of Philadelphia AWS infrastructure",
   "main": "dist/index.js",
   "bin": {
@@ -24,7 +24,7 @@
     "commander": "^11.0.0",
     "fs-extra": "^11.1.0",
     "inquirer": "^8.2.5",
-    "@phila/constructs": "0.0.1"
+    "@phila/constructs": "0.0.3"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.0",

package/dist/templates/_shared/dotnet-api/obj/Api.csproj.nuget.dgspec.json

@@ -1,80 +0,0 @@
-{
-  "format": 1,
-  "restore": {
-    "/Users/alejandro.lopez/code/phila-ctl/templates/_shared/dotnet-api/Api.csproj": {}
-  },
-  "projects": {
-    "/Users/alejandro.lopez/code/phila-ctl/templates/_shared/dotnet-api/Api.csproj": {
-      "version": "1.0.0",
-      "restore": {
-        "projectUniqueName": "/Users/alejandro.lopez/code/phila-ctl/templates/_shared/dotnet-api/Api.csproj",
-        "projectName": "Api",
-        "projectPath": "/Users/alejandro.lopez/code/phila-ctl/templates/_shared/dotnet-api/Api.csproj",
-        "packagesPath": "/Users/alejandro.lopez/.nuget/packages/",
-        "outputPath": "/Users/alejandro.lopez/code/phila-ctl/templates/_shared/dotnet-api/obj/",
-        "projectStyle": "PackageReference",
-        "configFilePaths": [
-          "/Users/alejandro.lopez/.nuget/NuGet/NuGet.Config"
-        ],
-        "originalTargetFrameworks": [
-          "net8.0"
-        ],
-        "sources": {
-          "https://api.nuget.org/v3/index.json": {},
-          "https://philagov-102658671810.d.codeartifact.us-east-1.amazonaws.com/nuget/se-team/v3/index.json": {}
-        },
-        "frameworks": {
-          "net8.0": {
-            "targetAlias": "net8.0",
-            "projectReferences": {}
-          }
-        },
-        "warningProperties": {
-          "warnAsError": [
-            "NU1605"
-          ]
-        },
-        "restoreAuditProperties": {
-          "enableAudit": "true",
-          "auditLevel": "low",
-          "auditMode": "direct"
-        }
-      },
-      "frameworks": {
-        "net8.0": {
-          "targetAlias": "net8.0",
-          "dependencies": {
-            "Amazon.Lambda.AspNetCoreServer.Hosting": {
-              "target": "Package",
-              "version": "[1.7.2, )"
-            },
-            "Amazon.Lambda.Serialization.SystemTextJson": {
-              "target": "Package",
-              "version": "[2.4.4, )"
-            }
-          },
-          "imports": [
-            "net461",
-            "net462",
-            "net47",
-            "net471",
-            "net472",
-            "net48",
-            "net481"
-          ],
-          "assetTargetFallback": true,
-          "warn": true,
-          "frameworkReferences": {
-            "Microsoft.AspNetCore.App": {
-              "privateAssets": "none"
-            },
-            "Microsoft.NETCore.App": {
-              "privateAssets": "all"
-            }
-          },
-          "runtimeIdentifierGraphPath": "/usr/local/share/dotnet/sdk/8.0.403/PortableRuntimeIdentifierGraph.json"
-        }
-      }
-    }
-  }
-}

package/dist/templates/_shared/dotnet-api/obj/Api.csproj.nuget.g.props

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="utf-8" standalone="no"?>
-<Project ToolsVersion="14.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <PropertyGroup Condition=" '$(ExcludeRestorePackageImports)' != 'true' ">
-    <RestoreSuccess Condition=" '$(RestoreSuccess)' == '' ">True</RestoreSuccess>
-    <RestoreTool Condition=" '$(RestoreTool)' == '' ">NuGet</RestoreTool>
-    <ProjectAssetsFile Condition=" '$(ProjectAssetsFile)' == '' ">$(MSBuildThisFileDirectory)project.assets.json</ProjectAssetsFile>
-    <NuGetPackageRoot Condition=" '$(NuGetPackageRoot)' == '' ">/Users/alejandro.lopez/.nuget/packages/</NuGetPackageRoot>
-    <NuGetPackageFolders Condition=" '$(NuGetPackageFolders)' == '' ">/Users/alejandro.lopez/.nuget/packages/</NuGetPackageFolders>
-    <NuGetProjectStyle Condition=" '$(NuGetProjectStyle)' == '' ">PackageReference</NuGetProjectStyle>
-    <NuGetToolVersion Condition=" '$(NuGetToolVersion)' == '' ">6.11.1</NuGetToolVersion>
-  </PropertyGroup>
-  <ItemGroup Condition=" '$(ExcludeRestorePackageImports)' != 'true' ">
-    <SourceRoot Include="/Users/alejandro.lopez/.nuget/packages/" />
-  </ItemGroup>
-</Project>

package/dist/templates/_shared/dotnet-api/obj/Api.csproj.nuget.g.targets

@@ -1,2 +0,0 @@
-<?xml version="1.0" encoding="utf-8" standalone="no"?>
-<Project ToolsVersion="14.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003" />

package/dist/templates/_shared/dotnet-api/obj/Debug/net8.0/.NETCoreApp,Version=v8.0.AssemblyAttributes.cs

@@ -1,4 +0,0 @@
-// <autogenerated />
-using System;
-using System.Reflection;
-[assembly: global::System.Runtime.Versioning.TargetFrameworkAttribute(".NETCoreApp,Version=v8.0", FrameworkDisplayName = ".NET 8.0")]

package/dist/templates/_shared/dotnet-api/obj/Debug/net8.0/Api.AssemblyInfo.cs

@@ -1,22 +0,0 @@
-//------------------------------------------------------------------------------
-// <auto-generated>
-//     This code was generated by a tool.
-//
-//     Changes to this file may cause incorrect behavior and will be lost if
-//     the code is regenerated.
-// </auto-generated>
-//------------------------------------------------------------------------------
-
-using System;
-using System.Reflection;
-
-[assembly: System.Reflection.AssemblyCompanyAttribute("Api")]
-[assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
-[assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+f4db1eb14515a4157a4850a57c0b8c85baa6740e")]
-[assembly: System.Reflection.AssemblyProductAttribute("Api")]
-[assembly: System.Reflection.AssemblyTitleAttribute("Api")]
-[assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]
-
-// Generated by the MSBuild WriteCodeFragment class.
-

package/dist/templates/_shared/dotnet-api/obj/Debug/net8.0/Api.AssemblyInfoInputs.cache

@@ -1 +0,0 @@
-1799ac38bbc38f0c289f5500dbe232d0d25d9ca54a2558cbd39eded73fb8a4ca

package/dist/templates/_shared/dotnet-api/obj/Debug/net8.0/Api.GeneratedMSBuildEditorConfig.editorconfig

@@ -1,19 +0,0 @@
-is_global = true
-build_property.TargetFramework = net8.0
-build_property.TargetPlatformMinVersion = 
-build_property.UsingMicrosoftNETSdkWeb = true
-build_property.ProjectTypeGuids = 
-build_property.InvariantGlobalization = 
-build_property.PlatformNeutralAssembly = 
-build_property.EnforceExtendedAnalyzerRules = 
-build_property._SupportedPlatformList = Linux,macOS,Windows
-build_property.RootNamespace = Api
-build_property.RootNamespace = Api
-build_property.ProjectDir = /Users/alejandro.lopez/code/phila-ctl/packages/cli/dist/templates/_shared/dotnet-api/
-build_property.EnableComHosting = 
-build_property.EnableGeneratedComInterfaceComImportInterop = 
-build_property.RazorLangVersion = 8.0
-build_property.SupportLocalizedComponentNames = 
-build_property.GenerateRazorMetadataSourceChecksumAttributes = 
-build_property.MSBuildProjectDirectory = /Users/alejandro.lopez/code/phila-ctl/packages/cli/dist/templates/_shared/dotnet-api
-build_property._RazorSourceGeneratorDebug = 

package/dist/templates/_shared/dotnet-api/obj/Debug/net8.0/Api.GlobalUsings.g.cs

@@ -1,17 +0,0 @@
-// <auto-generated/>
-global using global::Microsoft.AspNetCore.Builder;
-global using global::Microsoft.AspNetCore.Hosting;
-global using global::Microsoft.AspNetCore.Http;
-global using global::Microsoft.AspNetCore.Routing;
-global using global::Microsoft.Extensions.Configuration;
-global using global::Microsoft.Extensions.DependencyInjection;
-global using global::Microsoft.Extensions.Hosting;
-global using global::Microsoft.Extensions.Logging;
-global using global::System;
-global using global::System.Collections.Generic;
-global using global::System.IO;
-global using global::System.Linq;
-global using global::System.Net.Http;
-global using global::System.Net.Http.Json;
-global using global::System.Threading;
-global using global::System.Threading.Tasks;