@archinsight/cli 3.0.0 → 3.0.2

package/README.md

@@ -11,8 +11,8 @@ It embeds `@insight/language` directly and does not call the web app.
 ```shell
 archinsight link [project-dir] [--format text|json] [--out file]
 archinsight structure [project-dir] [--format text|json] [--out file]
-archinsight query [project-dir] -c <context> [-s <source>] [-v c1|c2|c3|c4|no-filter] [-q query.aiq] [-f text|json] [-o file]
-archinsight render [project-dir] -c <context> [-s <source>] [-v c1|c2|c3|c4|no-filter] [-q query.aiq] [-f dot|svg|json] [-o file]
+archinsight query [project-dir] -c <context> [-s <source>] [-v c1|c2|c3|c4|deployment|no-filter] [-q query.aiq] [-f text|json] [-o file]
+archinsight render [project-dir] -c <context> [-s <source>] [-v c1|c2|c3|c4|deployment|no-filter] [-q query.aiq] [-f dot|svg|json] [-o file]
 archinsight skill init [project-dir] [--target generic|codex|claude] [--out dir] [--force]
 ```
 
@@ -23,14 +23,15 @@ archinsight skill init [project-dir] [--target generic|codex|claude] [--out dir]
 - `-c, --context <id>` - context id for query/render.
 - `-s, --source <file>` - selected source file for queries using `$tab`.
 - `--tab <source>` - compatibility alias for `--source`.
-- `-v, --view <name>` - built-in view: `c1`, `c2`, `c3`, `c4`, `no-filter`.
+- `-v, --view <name>` - built-in view: `c1`, `c2`, `c3`, `c4`, `deployment`, `no-filter`.
 - `-q, --query <file>` - custom query file; overrides `--view`; relative paths
   are resolved from `project-dir`.
 - `-f, --format <format>` - command output format.
 - `-o, --out <file>` - write payload output to a file instead of stdout.
 - `-t, --theme <theme>` - render theme; defaults to `light`.
 - `--target <target>` - skill target for `skill init`: `generic`, `codex`, or `claude`.
-- `--force` - delete and recreate the generated skill directory before writing.
+- `--force` - replace the complete generated skill directory after the new
+  package has been generated successfully.
 - `-V, --version` - print version.
 - `-h, --help` - print help.
 
@@ -61,16 +62,20 @@ The generic target writes a runtime-neutral guide:
 .archinsight/agent/
     archinsight.md
     references/
+        cli.md
         modeling.md
+        importing-models.md
         syntax.md
         layered-architecture.md
         c1-context.md
         c2-containers.md
         c3-components.md
-        c4-deployment.md
+        c4-code.md
+        deployment.md
         scaling.md
         project-structure.md
         core.md
+        analysis.md
         queries.md
         query-recipes.md
         validation.md
@@ -81,10 +86,13 @@ The generic target writes a runtime-neutral guide:
         c1-context.ai
         c2-containers.ai
         c3-components.ai
-        c4-deployment-framework.ai
-        c4-deployment-infrastructure.ai
-        c4-deployment.ai
-        c4-private-gateway/
+        c4-code/
+            definitions.ai
+            model.ai
+        deployment-framework.ai
+        deployment-infrastructure.ai
+        deployment.ai
+        deployment-private-gateway/
             deployment-framework.ai
             source-infra.ai
             source-system.ai
@@ -98,6 +106,9 @@ The generic target writes a runtime-neutral guide:
             c2.aiq
             c3.aiq
             c4.aiq
+            deployment.aiq
+        queries/
+            deployment-internal-actors.aiq
 ```
 
 Codex and Claude targets package the same Insight reference directly into the
@@ -125,11 +136,22 @@ After generating a Codex or Claude skill into the default location, restart the
 agent session so the skill is discovered. Pass `--out <dir>` to write the same
 package somewhere else.
 
-The guide tells agents to treat `archinsight` as the validation source of truth,
+The guide records the exact CLI version that generated it and tells agents to regenerate the package when that version differs, treat `archinsight` as the validation source of truth,
 avoid guessing Insight syntax from other architecture DSLs, inspect project
 structure before broad edits or imports, read bundled core language sources for
 built-in types/presentations/projections, describe systems layer by layer, and
 write custom `.aiq` diagram queries with the supported Cypher-style subset.
+Dedicated references cover semantic import from C4-oriented DSLs, diagrams,
+inventories, and prose, plus read-only analysis through structure inspection,
+focused queries, and processing of query JSON when the query subset does not
+provide aggregation or graph traversal.
+For deployment and query changes it requires `query --format json` semantic
+inspection before rendering. The JSON reference distinguishes selected graph
+endpoints, underlying linked edges, and logical projection origins.
+The bundled C4 reference explains the constructorless `CodeElement` extension
+point, project-defined code vocabularies, component containment, and the
+minimal built-in query that selects code elements from the current semantic
+tab.
 The bundled deployment reference explains context-owned profiles with
 `appliesTo: <deployment> from <environment>`, element placement through those
 profiles, and wire-level `uses` restricted to `NetworkConnection` descendants.