@archinsight/cli 3.0.0-snapshot.7 → 3.0.1

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,26 +62,43 @@ 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
     .core/
         *.ai
     examples/
+        layered-architecture.ai
         c1-context.ai
         c2-containers.ai
         c3-components.ai
-        c4-deployment-framework.ai
-        c4-deployment.ai
+        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
+            target-infra.ai
+            target-system.ai
+            external.ai
         c2-containers.aiq
         builtin-views/
             no-filter.aiq
@@ -88,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
@@ -115,15 +136,26 @@ 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.
-The bundled core reference includes standard deployment infrastructure
-constructors such as `compute`, `storage`, `broker`, and `networkConnection`,
-including projection rules for storage, broker dependencies, and direct network
-paths.
+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.
+Its examples also cover projection rules for storage and physical network paths.
 
 ## Output Contract
 
@@ -180,3 +212,9 @@ npm --prefix archinsight-cli run publish:npm
 
 Before publishing, update the package version in `package.json`, commit the
 change, and make sure the working tree is clean.
+
+## License
+
+Copyright 2021-2026 Alexey Zaytsev
+
+Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE).