(human) some doc updates, version value bumps, other cleanup/polish

Author: verdverm

examples/env/README.md

@@ -426,55 +426,59 @@ Generally speaking...
 ```
 Dir               add a directory
 File              add a file
+
+Changes           applies #Changes to a container
+Patch             applies a git-like patch or #Changes
+PatchFile         applies a #PatchFile
+RootFS            set the root FS of a container
+
 EnvVars           add a set of env vars
 SecretVars        add a set of secret vars
 EnvFile           add an env var file
 SecretFile        add a secret var file
 
-Temp              a temp volume for the next exec
-Mount             mount a cache, file, directory, secret
-UnixSocket        mount a unix socket at a path
-BindService       bind another service to the container  (hint, dep graph)
-Expose            mark a port for servin
-
 Sync              force evaluation of the dagger graph
 Exec              run any command as a container layer
 Sh, Bash, Zsh     exec wrappers with a 'script' param
 User              set the current user
 Workdir           set the current workdir
 
-
 Entrypoint        set container entrypoint
 DefaultArgs       set container default args
 DefaultTerm       set the terminal dagger uses when needed
+Terminal          start a terminal at any or many point(s), directory or container
 
-!!!
-Terminal          drop into a terminal at any or many point(s), directory or container
-!!!               (this is one of the coolest dagger features)
+Temp              a temp volume for the next exec
+Mount             mount a cache, file, directory, secret
+UnixSocket        mount a unix socket at a path
+BindService       bind another service to the container  (hint, dep graph)
+Expose            mark a port for servin
 
-More to come...
+                  these all remove from a container as a new layer
+WithoutDefaultArgs
+WithoutDirectory
+WithoutEntrypoint
+WithoutEnvVariable
+WithoutExposedPort
+WithoutFile
+WithoutFiles
+WithoutLabel
+WithoutMount
+WithoutRegistryAuth
+WithoutSecretVariable
+WithoutUnixSocket
+WithoutUser
+WithoutWorkdir
+```
+<!-- More to come...
 
 - VsCode (like terminal, combo of them too)
 - Chown
-- $Filter (#Dir->#Dir)
-- $Diff (#Dir-#Dir->#Dir)
-- Patch & #Patch
-- Diff & #Diff, Changes & #Changeset
 - ?Merge (not overwrite, doesn't exist yet)
 - #DirToGit         git from a dir
 
-Vscode            (we'll add a Step to open in vscode, or make something that does both, configurablely)
+Vscode            (we'll add a Step to open in vscode, or make something that does both, configurablely) -->
 
-Without...
-  -- both #Dir and #Container
-  Dir
-  File
-  Files
-  -- #Containers only
-  EnvVar
-  SecretVar
-
-```
 
 ### #Stuff:
 
@@ -489,6 +493,11 @@ These are artifacts, intermediates, or resources you can work with
 #File             a file that can be used in CUE
 #Secret           a secret that will be elided from output
 #Cache            a named volume in memory, persists sessions
+#RootFS           get the root FS for a container
+
+#Changes          calculate the diff between two directories
+#PatchFile        convert #Changes into a patch #File
+#Shouldi          condition evaluation based on git diffs
 
 #Cmd              a custom command with named subtasks
 #Task             a task is a list of runnables and is runnable itself
@@ -501,16 +510,20 @@ These are artifacts, intermediates, or resources you can work with
 #HostService      expose host to dagger
 #HostTunnel       expose dagger to host
 #HostSocket       from a path
+#HostExec         run a command on the host (!outside of containers!)
 
 #ExportDir        to host path
 #ExportFile       to host path
 #ExportImageFile  to a tarball
 #ExportImage      to local engine
 #PublishImage     to a registry
 
+
+# helpers, not #things, but work / make them
+#Flatten          create a new container from scratch and an existing container or directory
+
 # many data formats available
-#ExportCuefig     returns a #File for the CUE representation any #Thing
-#ExportDagger     returns a #File for the Dagger representation any #Thing
+#CuefigSBOM       returns a #File with the CUE/Dagger representation for any #Thing
 ```
 
 ## Examples

extensions/vscode/extension/package.cue

@@ -5,7 +5,7 @@ displayName: "Veg"
 description: "Veg VS Code Extension"
 repository:  "github.com/hofstadter-io/hof"
 publisher:   "verdverm"
-version:     "0.0.1"
+version:     "v0.7.0-alpha.2"
 engines: {
 	vscode: "^1.106.0"
 }

extensions/vscode/extension/package.json

@@ -4,7 +4,7 @@
   "description": "Veg VS Code Extension",
   "repository": "github.com/hofstadter-io/hof",
   "publisher": "verdverm",
-  "version": "0.0.1",
+  "version": "v0.7.0-alpha.2",
   "engines": {
     "vscode": "^1.106.0"
   },

schemas/env/diff.cue

@@ -39,7 +39,7 @@ Changes: Step & {
   source: string | #Changes
 }
 
-// patch a #Container with a git-lie patch or #Changes
+// patch a #Container with a git-like patch or #Changes
 Patch: Step & {
 	$kind: "patch"
   source: string | #Changes

schemas/env/route.cue

@@ -0,0 +1,29 @@
+package env
+
+#Method: *"GET" | "POST" | "PUT" | "DELETE" | "OPTIONS" | "HEAD" | "CONNECT" | "TRACE" | "PATCH"
+
+#Route: Ref & {
+  // normal http / rest stuff
+  // webhook / other validation
+
+  path: string
+  method: #Method
+
+
+  input: {
+    url:    string
+
+    headers: [string]: string
+    query: [string]:   string
+
+    body: bytes | string | *{} // assumed json body if object
+  }
+
+  // some #Thing that get's Sync/Export/Etc...
+  vegOp: "SYNC" | "EXPORT" | "CMD"
+  handler: _
+
+
+  routes: [...#Route]
+}
+

schemas/env/sbom.cue

@@ -5,15 +5,6 @@ import (
 )
 
 
-// supported formats for sbom generators
-
-// common fields for sbom generators, used internally
-sbomCommon: {
-	name?:    string
-	path:    string
-	data:    _
-}
-
 // generate the CUE representation
 // is a: *dagger.File with format:[cue,json,yaml,toml] content
 // data: any CUE value
@@ -27,23 +18,9 @@ sbomCommon: {
 	$kind:   "#cuefigSBOM"
 	format:  or(["cue", "json", "yaml", "toml"])
 
-  sbomCommon 
+	name?:    string
+	path:    string
+	data:    _
 }
 
-// generate the Dagger representation
-// is a: *dagger.File with JSON content
-// data: any *dagger.Object (env.Ref, i.e. #Things)
-// hmmm, can we reverse this one?
-// update, can't seem to get anything reasonable out of dagger for sbom, misleading function names / what they return, it's all internal ids to ephemeral object, not actual sbom material
-// #DaggerSBOM: Ref & {
-// 	schemas.Hof
-// 	#hof: env: {
-// 		root: true // need to figure out what this really means, how it interacts with discovery & cli vs walking a CUE value to construct a giant dagger dag
-// 		kind: "daggerSBOM"
-// 	}
-// 	$kind:   "#daggerSBOM"
-
-//   sbomCommon 
-// }
-
 // TODO, sigstore/cosign stuff