tarosec 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +137 -2
  3. package/SOURCE_NOTICES.md +14 -0
  4. package/package.json +17 -4
  5. package/skills/tarosec/LICENSE +21 -0
  6. package/skills/tarosec/SKILL.md +25 -0
  7. package/skills/tarosec/SOURCE_NOTICES.md +14 -0
  8. package/skills/tarosec/assets/schemas/case.schema.json +34 -0
  9. package/skills/tarosec/assets/schemas/engagement.schema.json +78 -0
  10. package/skills/tarosec/assets/schemas/evidence.schema.json +38 -0
  11. package/skills/tarosec/assets/schemas/exercise.schema.json +128 -0
  12. package/skills/tarosec/assets/schemas/finding.schema.json +46 -0
  13. package/skills/tarosec/references/routing.md +26 -0
  14. package/skills/tarosec/references/shared/authorization.md +56 -0
  15. package/skills/tarosec/references/shared/evidence-handling.md +43 -0
  16. package/skills/tarosec/references/shared/security-standards.md +34 -0
  17. package/skills/tarosec/scripts/route.py +38 -0
  18. package/skills/tarosec/scripts/validate_record.py +123 -0
  19. package/skills/tarosec-audit/LICENSE +21 -0
  20. package/skills/tarosec-audit/SKILL.md +52 -0
  21. package/skills/tarosec-audit/SOURCE_NOTICES.md +14 -0
  22. package/skills/tarosec-audit/assets/schemas/case.schema.json +34 -0
  23. package/skills/tarosec-audit/assets/schemas/engagement.schema.json +78 -0
  24. package/skills/tarosec-audit/assets/schemas/evidence.schema.json +38 -0
  25. package/skills/tarosec-audit/assets/schemas/exercise.schema.json +128 -0
  26. package/skills/tarosec-audit/assets/schemas/finding.schema.json +46 -0
  27. package/skills/tarosec-audit/references/agents.md +22 -0
  28. package/skills/tarosec-audit/references/dependencies.md +14 -0
  29. package/skills/tarosec-audit/references/shared/authorization.md +56 -0
  30. package/skills/tarosec-audit/references/shared/evidence-handling.md +43 -0
  31. package/skills/tarosec-audit/references/shared/security-standards.md +34 -0
  32. package/skills/tarosec-audit/scripts/validate_record.py +123 -0
  33. package/skills/tarosec-blue/LICENSE +21 -0
  34. package/skills/tarosec-blue/SKILL.md +56 -0
  35. package/skills/tarosec-blue/SOURCE_NOTICES.md +14 -0
  36. package/skills/tarosec-blue/assets/schemas/case.schema.json +34 -0
  37. package/skills/tarosec-blue/assets/schemas/engagement.schema.json +78 -0
  38. package/skills/tarosec-blue/assets/schemas/evidence.schema.json +38 -0
  39. package/skills/tarosec-blue/assets/schemas/exercise.schema.json +128 -0
  40. package/skills/tarosec-blue/assets/schemas/finding.schema.json +46 -0
  41. package/skills/tarosec-blue/references/detection-engineering.md +18 -0
  42. package/skills/tarosec-blue/references/shared/authorization.md +56 -0
  43. package/skills/tarosec-blue/references/shared/evidence-handling.md +43 -0
  44. package/skills/tarosec-blue/references/shared/security-standards.md +34 -0
  45. package/skills/tarosec-blue/scripts/validate_record.py +123 -0
  46. package/skills/tarosec-purple/LICENSE +21 -0
  47. package/skills/tarosec-purple/SKILL.md +85 -0
  48. package/skills/tarosec-purple/SOURCE_NOTICES.md +14 -0
  49. package/skills/tarosec-purple/assets/schemas/case.schema.json +34 -0
  50. package/skills/tarosec-purple/assets/schemas/engagement.schema.json +78 -0
  51. package/skills/tarosec-purple/assets/schemas/evidence.schema.json +38 -0
  52. package/skills/tarosec-purple/assets/schemas/exercise.schema.json +128 -0
  53. package/skills/tarosec-purple/assets/schemas/finding.schema.json +46 -0
  54. package/skills/tarosec-purple/references/exercise-design.md +36 -0
  55. package/skills/tarosec-purple/references/shared/authorization.md +56 -0
  56. package/skills/tarosec-purple/references/shared/evidence-handling.md +43 -0
  57. package/skills/tarosec-purple/references/shared/security-standards.md +34 -0
  58. package/skills/tarosec-purple/scripts/__pycache__/classify_exercise.cpython-315.pyc +0 -0
  59. package/skills/tarosec-purple/scripts/__pycache__/validate_record.cpython-315.pyc +0 -0
  60. package/skills/tarosec-purple/scripts/classify_exercise.py +170 -0
  61. package/skills/tarosec-purple/scripts/validate_record.py +123 -0
  62. package/skills/tarosec-red/LICENSE +21 -0
  63. package/skills/tarosec-red/SKILL.md +47 -0
  64. package/skills/tarosec-red/SOURCE_NOTICES.md +14 -0
  65. package/skills/tarosec-red/assets/schemas/case.schema.json +34 -0
  66. package/skills/tarosec-red/assets/schemas/engagement.schema.json +78 -0
  67. package/skills/tarosec-red/assets/schemas/evidence.schema.json +38 -0
  68. package/skills/tarosec-red/assets/schemas/exercise.schema.json +128 -0
  69. package/skills/tarosec-red/assets/schemas/finding.schema.json +46 -0
  70. package/skills/tarosec-red/references/scope.md +16 -0
  71. package/skills/tarosec-red/references/shared/authorization.md +56 -0
  72. package/skills/tarosec-red/references/shared/evidence-handling.md +43 -0
  73. package/skills/tarosec-red/references/shared/security-standards.md +34 -0
  74. package/skills/tarosec-red/scripts/validate_record.py +123 -0
  75. package/skills/tarosec-simulate/LICENSE +21 -0
  76. package/skills/tarosec-simulate/SKILL.md +32 -0
  77. package/skills/tarosec-simulate/SOURCE_NOTICES.md +14 -0
  78. package/skills/tarosec-simulate/assets/scenarios/auth.suspicious-login/events.json +22 -0
  79. package/skills/tarosec-simulate/assets/scenarios/auth.suspicious-login/scenario.json +16 -0
  80. package/skills/tarosec-simulate/assets/scenarios/endpoint.ransomware-behavior/events.json +22 -0
  81. package/skills/tarosec-simulate/assets/scenarios/endpoint.ransomware-behavior/scenario.json +16 -0
  82. package/skills/tarosec-simulate/assets/scenarios/web.attack-patterns/events.json +14 -0
  83. package/skills/tarosec-simulate/assets/scenarios/web.attack-patterns/scenario.json +15 -0
  84. package/skills/tarosec-simulate/assets/schemas/case.schema.json +34 -0
  85. package/skills/tarosec-simulate/assets/schemas/engagement.schema.json +78 -0
  86. package/skills/tarosec-simulate/assets/schemas/evidence.schema.json +38 -0
  87. package/skills/tarosec-simulate/assets/schemas/exercise.schema.json +128 -0
  88. package/skills/tarosec-simulate/assets/schemas/finding.schema.json +46 -0
  89. package/skills/tarosec-simulate/assets/schemas/scenario.schema.json +64 -0
  90. package/skills/tarosec-simulate/assets/schemas/simulation-alerts.schema.json +51 -0
  91. package/skills/tarosec-simulate/assets/schemas/simulation-events.schema.json +39 -0
  92. package/skills/tarosec-simulate/assets/schemas/simulation-result.schema.json +144 -0
  93. package/skills/tarosec-simulate/references/shared/authorization.md +56 -0
  94. package/skills/tarosec-simulate/references/shared/evidence-handling.md +43 -0
  95. package/skills/tarosec-simulate/references/shared/security-standards.md +34 -0
  96. package/skills/tarosec-simulate/references/simulation.md +29 -0
  97. package/skills/tarosec-simulate/scripts/classify_exercise.py +170 -0
  98. package/skills/tarosec-simulate/scripts/simulate.py +254 -0
  99. package/skills/tarosec-simulate/scripts/validate_record.py +123 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 The Refactor Room
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,138 @@
1
- # Temporary Holding Version
1
+ # Tarosec
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ ![Tarosec dog mascot and wordmark](design/tarosec-dog-logo-concept.png)
4
+
5
+ **Assess. Defend. Validate. Improve.**
6
+
7
+ Tarosec is an offline cybersecurity skill suite for developers, security
8
+ reviewers, and detection engineers using AI coding agents. It helps agents turn
9
+ source code, assessment records, and telemetry into evidence-backed findings.
10
+
11
+ ## Start with `$tarosec`
12
+
13
+ Install the suite using the local checkout commands below, then enter one of
14
+ these requests in your coding agent.
15
+
16
+ - `$tarosec ./project` starts a read-only source and configuration review.
17
+ - `$tarosec blue ./logs` investigates supplied telemetry.
18
+ - `$tarosec simulate suspicious-login` generates a synthetic fixture and report.
19
+ - `$tarosec verify ./case` selects Audit or Purple based on the supplied evidence.
20
+ - `$tarosec help` lists workflows and explains any missing specialists.
21
+
22
+ The entry point checks which specialists are installed before choosing a
23
+ workflow. The existing specialists remain available for direct use.
24
+
25
+ | Skill | Use it for | Modes |
26
+ | --- | --- | --- |
27
+ | [Tarosec Audit](skills/tarosec-audit/SKILL.md) | Audit source, dependencies, CI/CD, MCP and Agent Skills | `quick`, `deep`, `dependencies`, `agents`, `verify` |
28
+ | [Tarosec Red](skills/tarosec-red/SKILL.md) | Review scope, inventory exposed assets, and triage supplied assessment results | `recon`, `scan`, `simulate`, `bounty`, `validate` |
29
+ | [Tarosec Blue](skills/tarosec-blue/SKILL.md) | Investigate supplied telemetry and design or verify detection logic | `hunt`, `triage`, `logs`, `detect`, `verify`, `monitor` |
30
+ | [Tarosec Purple](skills/tarosec-purple/SKILL.md) | Compare recorded exercise steps with expected telemetry and alerts | `plan`, `exercise`, `emulate`, `validate`, `coverage`, `retest` |
31
+ | [Tarosec Simulate](skills/tarosec-simulate/SKILL.md) | Generate controlled event records or replay sanitized evidence | `list`, `synthetic`, `replay` |
32
+
33
+ Use the modes as cues in an agent request. The deterministic Python helpers
34
+ require Python 3.10 or later.
35
+
36
+ ## Install from GitHub
37
+
38
+ Install all Tarosec skills in the current project with the [Skills CLI](https://github.com/vercel-labs/skills):
39
+
40
+ ```bash
41
+ npx skills add refactorroom/tarosec
42
+ ```
43
+
44
+ Select individual skills or install for specific agents:
45
+
46
+ ```bash
47
+ npx skills add refactorroom/tarosec --skill tarosec --skill tarosec-simulate
48
+ npx skills add refactorroom/tarosec --skill tarosec-audit --agent codex claude-code
49
+ npx skills add refactorroom/tarosec --list
50
+ npx skills list
51
+ ```
52
+
53
+ Add `--global` when installing for your user account. After installation, start
54
+ a new agent session and request `$tarosec ./project` or `$tarosec simulate suspicious-login`.
55
+ The [Skills directory](https://skills.sh/docs/faq) discovers public skills from
56
+ installation activity.
57
+
58
+ ## Install from a local checkout
59
+
60
+ Run from the project where you want to use Tarosec. Replace the source path with
61
+ the absolute path to this checkout.
62
+
63
+ ```bash
64
+ npx skills@1.9.0 add /path/to/tarosec --list
65
+ npx skills@1.9.0 add /path/to/tarosec --skill '*' --agent codex claude-code --copy -y
66
+ npx skills@1.9.0 list --agent codex claude-code
67
+ ```
68
+
69
+ Select a single skill with `--skill tarosec-purple`, or choose one agent with
70
+ `--agent codex` or `--agent claude-code`. These project-level commands were
71
+ checked locally with Vercel Skills 1.9.0. For a session-only Claude Code plugin,
72
+ use `claude --plugin-dir /path/to/tarosec`. See [installation and troubleshooting](docs/install.md).
73
+
74
+ ## Try it offline
75
+
76
+ Run the helper from this checkout to reproduce the suspicious login demo. Choose
77
+ a fresh directory for `./login-report`.
78
+
79
+ ```bash
80
+ python3 -B skills/tarosec-simulate/scripts/simulate.py synthetic suspicious-login --output ./login-report
81
+ ```
82
+
83
+ The captured run generated five events and returned **Inconclusive** because it
84
+ had no independent rule observations. The [run report](examples/simulation/suspicious-login/report.md)
85
+ links the assessment to hashed evidence. See the [catalog and replay guide](docs/simulation.md).
86
+
87
+ Open this checkout with the desired skill installed, then give the agent one
88
+ of these requests. Fixture inputs are under [evaluations](evaluations/fixtures).
89
+
90
+ - **Audit** — Review `evaluations/fixtures/A1-audit-green-idor/app/invoices.py`
91
+ and the tests beside it. Check invoice read and refund authorization against
92
+ the policy in the fixture's `TASK.md`. Cite the effective guard and coverage gaps.
93
+ - **Red** — Review `evaluations/fixtures/R1-red-scope/engagement.json` and
94
+ `recon-notes.md`. List supplied assets and separate in-scope, excluded and
95
+ unverified entries. Keep the assessment offline.
96
+ - **Blue** — Triage `evaluations/fixtures/B2-blue-false-positive/events.jsonl`.
97
+ Correlate the alert with the change approval and job run. State which evidence
98
+ would change your conclusion.
99
+ - **Purple** — Compare `examples/exercise.example.json` and
100
+ `examples/exercise.retest.json`. Report the outcome for S1 and cite the evidence IDs.
101
+
102
+ The standalone Purple helper applies the same outcome table:
103
+
104
+ ```bash
105
+ python3 -B skills/tarosec-purple/scripts/classify_exercise.py examples/exercise.example.json --json
106
+ python3 -B skills/tarosec-purple/scripts/classify_exercise.py examples/exercise.retest.json --json
107
+ ```
108
+
109
+ The supplied event initially has a **Detection gap**. The retest records
110
+ **Detected** with a 12-second delay. Both runs use synthetic records. See the
111
+ [worked example](examples/README.md) for the evidence chain and inconclusive case.
112
+
113
+ ## Boundaries and limitations
114
+
115
+ Tarosec v0.1 works from supplied artifacts and benign synthetic data. It
116
+ supports offline asset inventory, scan-report review, defensive investigations,
117
+ and detection exercises. Active scans, exploitation, live emulation, and
118
+ production execution are outside the release scope.
119
+
120
+ An engagement record documents scope. Authority comes from the operator.
121
+ Skill guidance depends on the host for tool, filesystem and network restrictions.
122
+ Use the [authorization rules](references/authorization.md) and
123
+ [evidence-handling guidance](references/evidence-handling.md) when reviewing private data.
124
+
125
+ ## Development
126
+
127
+ ```bash
128
+ python3 -B scripts/sync_shared.py --check
129
+ python3 -B -m unittest discover -s tests -v
130
+ ```
131
+
132
+ Each directory under `skills/` bundles its instructions, references, schemas,
133
+ validator and license notices. Edit shared files at the repository root and run
134
+ `python3 -B scripts/sync_shared.py`. See the [architecture and roadmap](docs/design.md),
135
+ [migration assessment](docs/migration.md), [evaluation instructions](evaluations/README.md),
136
+ [release readiness](docs/release-readiness.md), and [contribution guide](CONTRIBUTING.md).
137
+
138
+ [MIT license](LICENSE) · [Source notices](SOURCE_NOTICES.md) · [Security policy](SECURITY.md)
@@ -0,0 +1,14 @@
1
+ # Source notices
2
+
3
+ Tarosec uses the MIT license. The copyright notice and terms are in [LICENSE](LICENSE).
4
+
5
+ Some audit, scope review, evidence handling, defensive investigation and exercise
6
+ design guidance adapts concepts from Panda Suite's `panda-security` and former
7
+ `panda-recon` skills. Panda Suite 1.9.0 distributes the successor security skills
8
+ under its MIT terms. The Panda Suite copyright notice is **Copyright (c) 2026
9
+ akkaraponph**. The upstream license has the same MIT terms as the bundled
10
+ license. [Panda Suite license at the inspected revision](https://github.com/refactorroom/panda-suite/blob/8c4aae1ee1b4a978957a8421b2b797bb7add3c0c/LICENSE)
11
+
12
+ Tarosec's JSON records, validation and classification helpers, fixture inputs,
13
+ and evaluation harness were authored for Tarosec. The standards and tool links
14
+ identify external references. Their content is not bundled.
package/package.json CHANGED
@@ -1,6 +1,19 @@
1
1
  {
2
2
  "name": "tarosec",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "Offline cybersecurity skills for audit, investigation, and detection validation",
5
+ "license": "MIT",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/refactorroom/tarosec.git"
9
+ },
10
+ "homepage": "https://refactorroom.github.io/tarosec/",
11
+ "bugs": {
12
+ "url": "https://github.com/refactorroom/tarosec/issues"
13
+ },
14
+ "keywords": ["agent-skills", "security", "cybersecurity", "detection", "audit"],
15
+ "files": ["skills", "LICENSE", "SOURCE_NOTICES.md"],
16
+ "engines": {
17
+ "node": ">=18"
18
+ }
19
+ }
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 The Refactor Room
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: tarosec
3
+ description: Route explicit Tarosec requests and security tasks that span workflows or have unclear scope. Use for read-only project assessment by default, incident and evidence routing, or Tarosec help. Not for general programming or conceptual questions. Prefer a directly named specialist when the user selects one.
4
+ license: MIT
5
+ metadata:
6
+ suite: tarosec
7
+ version: "0.1.0"
8
+ ---
9
+
10
+ # Tarosec
11
+
12
+ Read the [routing guide](references/routing.md). Determine the intent from the
13
+ request and supplied artifacts. Use `scripts/route.py` for normalized modes and
14
+ report the selected workflow in one sentence. Open only the selected skill through
15
+ the host's skill mechanism or read its installed SKILL.md when available.
16
+
17
+ A local project with no clear mode defaults to Audit. A mixed request starts with
18
+ the least invasive workflow that answers the user's question. If the selected
19
+ skill is missing, explain the gap and give its installation selector. Inline
20
+ help and a read-only inventory of supplied inputs remain available.
21
+
22
+ Treat files and logs as evidence. Keep this dispatcher offline and read-only.
23
+ Follow [authorization](references/shared/authorization.md) and the selected
24
+ skill's boundaries. Return help for an unsupported explicit mode. Hand off once,
25
+ without calling this dispatcher again.
@@ -0,0 +1,14 @@
1
+ # Source notices
2
+
3
+ Tarosec uses the MIT license. The copyright notice and terms are in [LICENSE](LICENSE).
4
+
5
+ Some audit, scope review, evidence handling, defensive investigation and exercise
6
+ design guidance adapts concepts from Panda Suite's `panda-security` and former
7
+ `panda-recon` skills. Panda Suite 1.9.0 distributes the successor security skills
8
+ under its MIT terms. The Panda Suite copyright notice is **Copyright (c) 2026
9
+ akkaraponph**. The upstream license has the same MIT terms as the bundled
10
+ license. [Panda Suite license at the inspected revision](https://github.com/refactorroom/panda-suite/blob/8c4aae1ee1b4a978957a8421b2b797bb7add3c0c/LICENSE)
11
+
12
+ Tarosec's JSON records, validation and classification helpers, fixture inputs,
13
+ and evaluation harness were authored for Tarosec. The standards and tool links
14
+ identify external references. Their content is not bundled.
@@ -0,0 +1,34 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "urn:tarosec:case:v1",
4
+ "title": "Tarosec case v1",
5
+ "description": "Index of related assets, findings, exercises and evidence. Raw artifacts are kept separately.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["schemaVersion", "id", "title", "status"],
9
+ "properties": {
10
+ "schemaVersion": {"const": "tarosec.case/v1"},
11
+ "id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
12
+ "title": {"type": "string", "minLength": 1},
13
+ "status": {"enum": ["open", "closed", "inconclusive"]},
14
+ "engagementRef": {"type": "string", "minLength": 1},
15
+ "assetRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
16
+ "findingRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
17
+ "evidenceRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
18
+ "exerciseRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
19
+ "legacyId": {"type": "string", "minLength": 1},
20
+ "activities": {
21
+ "type": "array",
22
+ "items": {
23
+ "type": "object",
24
+ "additionalProperties": false,
25
+ "required": ["at", "description"],
26
+ "properties": {
27
+ "at": {"type": "string", "minLength": 1},
28
+ "description": {"type": "string", "minLength": 1},
29
+ "evidenceRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}
30
+ }
31
+ }
32
+ }
33
+ }
34
+ }
@@ -0,0 +1,78 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "urn:tarosec:engagement:v1",
4
+ "title": "Tarosec engagement v1",
5
+ "description": "Describes permitted targets and techniques. It narrows scope; it is never authorization by itself.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["schemaVersion", "id", "name", "environment", "authorization", "scope", "techniques", "window", "budgets", "stopConditions"],
9
+ "properties": {
10
+ "schemaVersion": {"const": "tarosec.engagement/v1"},
11
+ "id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
12
+ "name": {"type": "string", "minLength": 1},
13
+ "environment": {"enum": ["offline", "laboratory", "staging", "production"]},
14
+ "authorization": {
15
+ "type": "object",
16
+ "additionalProperties": false,
17
+ "required": ["reference", "authorizedBy", "note"],
18
+ "properties": {
19
+ "reference": {"type": "string", "minLength": 1},
20
+ "authorizedBy": {"type": "string", "minLength": 1},
21
+ "note": {"type": "string", "minLength": 1}
22
+ }
23
+ },
24
+ "scope": {
25
+ "type": "object",
26
+ "additionalProperties": false,
27
+ "required": ["targets", "exclusions"],
28
+ "properties": {
29
+ "targets": {
30
+ "type": "array",
31
+ "minItems": 1,
32
+ "items": {
33
+ "type": "object",
34
+ "additionalProperties": false,
35
+ "required": ["id", "kind", "value"],
36
+ "properties": {
37
+ "id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
38
+ "kind": {"enum": ["origin", "url-prefix", "host", "ip", "cidr", "repository", "path", "lab-host"]},
39
+ "value": {"type": "string", "minLength": 1},
40
+ "allowedAddresses": {"type": "array", "items": {"type": "string", "minLength": 1}}
41
+ }
42
+ }
43
+ },
44
+ "exclusions": {"type": "array", "items": {"type": "string", "minLength": 1}}
45
+ }
46
+ },
47
+ "techniques": {
48
+ "type": "object",
49
+ "additionalProperties": false,
50
+ "required": ["allowed", "forbidden"],
51
+ "properties": {
52
+ "allowed": {"type": "array", "items": {"type": "string", "minLength": 1}},
53
+ "forbidden": {"type": "array", "items": {"type": "string", "minLength": 1}}
54
+ }
55
+ },
56
+ "window": {
57
+ "type": "object",
58
+ "additionalProperties": false,
59
+ "required": ["start", "end", "timezone"],
60
+ "properties": {
61
+ "start": {"type": "string", "minLength": 1},
62
+ "end": {"type": "string", "minLength": 1},
63
+ "timezone": {"type": "string", "minLength": 1}
64
+ }
65
+ },
66
+ "budgets": {
67
+ "type": "object",
68
+ "additionalProperties": false,
69
+ "properties": {
70
+ "maxRequestsPerSecond": {"type": "number", "minimum": 0},
71
+ "maxTotalRequests": {"type": "integer", "minimum": 0},
72
+ "maxDurationMinutes": {"type": "integer", "minimum": 0}
73
+ }
74
+ },
75
+ "stopConditions": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
76
+ "evidenceHandling": {"type": "string", "minLength": 1}
77
+ }
78
+ }
@@ -0,0 +1,38 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "urn:tarosec:evidence:v1",
4
+ "title": "Tarosec evidence v1",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schemaVersion", "id", "source", "collectionMethod", "collectedAt", "originalTimezone", "sensitivity", "integrity"],
8
+ "properties": {
9
+ "schemaVersion": {"const": "tarosec.evidence/v1"},
10
+ "id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
11
+ "source": {"type": "string", "minLength": 1},
12
+ "collectionMethod": {"type": "string", "minLength": 1},
13
+ "collectedBy": {"type": "string"},
14
+ "collectedAt": {"type": "string", "minLength": 1},
15
+ "originalTimezone": {"type": "string", "minLength": 1, "description": "IANA zone, UTC offset, or 'unknown'."},
16
+ "artifactPath": {"type": "string"},
17
+ "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
18
+ "sensitivity": {"enum": ["public", "internal", "confidential", "restricted"]},
19
+ "redacted": {"type": "boolean"},
20
+ "integrity": {"enum": ["verified-against-reference", "hash-recorded", "mismatch", "no-artifact", "unknown"]},
21
+ "limitations": {"type": "string"},
22
+ "relatedFindings": {"type": "array", "items": {"type": "string"}},
23
+ "relatedExercises": {"type": "array", "items": {"type": "string", "minLength": 1}},
24
+ "custody": {
25
+ "type": "array",
26
+ "items": {
27
+ "type": "object",
28
+ "additionalProperties": false,
29
+ "required": ["at", "actor", "action"],
30
+ "properties": {
31
+ "at": {"type": "string", "minLength": 1},
32
+ "actor": {"type": "string", "minLength": 1},
33
+ "action": {"type": "string", "minLength": 1}
34
+ }
35
+ }
36
+ }
37
+ }
38
+ }
@@ -0,0 +1,128 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "urn:tarosec:exercise:v1",
4
+ "title": "Tarosec purple exercise v1",
5
+ "description": "Expected defensive observations per emulation step, plus optional recorded results. Never authorization by itself.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["schemaVersion", "id", "name", "environment", "attackVersion", "window", "steps"],
9
+ "properties": {
10
+ "schemaVersion": {"const": "tarosec.exercise/v1"},
11
+ "id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
12
+ "name": {"type": "string", "minLength": 1},
13
+ "objective": {"type": "string", "minLength": 1},
14
+ "retestOf": {"type": "string", "minLength": 1},
15
+ "changeSummary": {"type": "string", "minLength": 1},
16
+ "limitations": {"type": "array", "items": {"type": "string", "minLength": 1}},
17
+ "engagementRef": {"type": "string"},
18
+ "environment": {"enum": ["offline", "laboratory", "staging", "production"]},
19
+ "attackVersion": {"type": "string", "minLength": 1},
20
+ "window": {
21
+ "type": "object",
22
+ "additionalProperties": false,
23
+ "required": ["start", "end"],
24
+ "properties": {
25
+ "start": {"type": "string", "minLength": 1},
26
+ "end": {"type": "string", "minLength": 1}
27
+ }
28
+ },
29
+ "steps": {
30
+ "type": "array",
31
+ "minItems": 1,
32
+ "items": {
33
+ "type": "object",
34
+ "additionalProperties": false,
35
+ "required": ["id", "description", "targetHost", "expected"],
36
+ "properties": {
37
+ "id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
38
+ "technique": {
39
+ "type": "object",
40
+ "additionalProperties": false,
41
+ "required": ["id", "name"],
42
+ "properties": {
43
+ "id": {"type": "string", "pattern": "^T[0-9]{4}(\\.[0-9]{3})?$"},
44
+ "name": {"type": "string", "minLength": 1}
45
+ }
46
+ },
47
+ "description": {"type": "string", "minLength": 1},
48
+ "targetHost": {"type": "string", "minLength": 1},
49
+ "countermeasures": {
50
+ "type": "array",
51
+ "items": {
52
+ "type": "object",
53
+ "additionalProperties": false,
54
+ "required": ["id", "name"],
55
+ "properties": {
56
+ "id": {"type": "string", "pattern": "^D3-[A-Z0-9]+$"},
57
+ "name": {"type": "string", "minLength": 1}
58
+ }
59
+ }
60
+ },
61
+ "expected": {
62
+ "type": "object",
63
+ "additionalProperties": false,
64
+ "required": ["telemetrySources", "detections", "maxLatencySeconds"],
65
+ "properties": {
66
+ "telemetrySources": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
67
+ "detections": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
68
+ "requireTelemetryForDetection": {"type": "boolean"},
69
+ "maxLatencySeconds": {"type": "integer", "minimum": 0}
70
+ }
71
+ },
72
+ "results": {
73
+ "type": "object",
74
+ "additionalProperties": false,
75
+ "required": ["execution"],
76
+ "properties": {
77
+ "execution": {
78
+ "type": "object",
79
+ "additionalProperties": false,
80
+ "required": ["status"],
81
+ "properties": {
82
+ "status": {"enum": ["executed", "failed", "blocked", "not_run", "unknown"]},
83
+ "startedAt": {"type": "string"},
84
+ "endedAt": {"type": "string"},
85
+ "prevented": {"type": "boolean"},
86
+ "evidenceRefs": {"type": "array", "items": {"type": "string"}}
87
+ }
88
+ },
89
+ "reportedOutcome": {
90
+ "description": "Optional analyst annotation. The classifier derives its outcome from the observations.",
91
+ "enum": ["Detected", "Detected (late)", "Partially detected", "Prevented", "Detection gap", "Telemetry gap", "Inconclusive", "Not run"]
92
+ },
93
+ "telemetry": {
94
+ "type": "array",
95
+ "items": {
96
+ "type": "object",
97
+ "additionalProperties": false,
98
+ "required": ["source", "status"],
99
+ "properties": {
100
+ "source": {"type": "string", "minLength": 1},
101
+ "status": {"enum": ["observed", "absent", "unknown"]},
102
+ "sourceHealthy": {"type": "boolean"},
103
+ "evidenceRefs": {"type": "array", "items": {"type": "string"}}
104
+ }
105
+ }
106
+ },
107
+ "alerts": {
108
+ "type": "array",
109
+ "items": {
110
+ "type": "object",
111
+ "additionalProperties": false,
112
+ "required": ["ruleId", "status"],
113
+ "properties": {
114
+ "ruleId": {"type": "string", "minLength": 1},
115
+ "status": {"enum": ["fired", "not_fired", "unknown"]},
116
+ "firedAt": {"type": "string"},
117
+ "host": {"type": "string"},
118
+ "evidenceRefs": {"type": "array", "items": {"type": "string"}}
119
+ }
120
+ }
121
+ }
122
+ }
123
+ }
124
+ }
125
+ }
126
+ }
127
+ }
128
+ }
@@ -0,0 +1,46 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "urn:tarosec:finding:v1",
4
+ "title": "Tarosec finding v1",
5
+ "description": "Shared by audit, red, blue and purple. Severity, confidence and status are independent axes.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["schemaVersion", "id", "producer", "title", "severity", "severityRationale", "confidence", "status", "claimStrength", "location", "invariant", "observed", "impact", "evidenceRefs", "remediation", "regressionCheck"],
9
+ "properties": {
10
+ "schemaVersion": {"const": "tarosec.finding/v1"},
11
+ "id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
12
+ "producer": {"enum": ["tarosec-audit", "tarosec-red", "tarosec-blue", "tarosec-purple"]},
13
+ "title": {"type": "string", "minLength": 1},
14
+ "description": {"type": "string", "minLength": 1},
15
+ "createdAt": {"type": "string", "minLength": 1},
16
+ "updatedAt": {"type": "string", "minLength": 1},
17
+ "severity": {"enum": ["Critical", "High", "Medium", "Low", "Informational"]},
18
+ "severityRationale": {"type": "string", "minLength": 1},
19
+ "confidence": {"enum": ["Confirmed", "Likely", "Unknown"]},
20
+ "status": {"enum": ["Potential weakness", "Verified vulnerability", "Simulation observation", "Detection gap", "Telemetry gap", "Informational", "False positive"]},
21
+ "verificationStatus": {"enum": ["unverified", "confirmed", "fixed", "inconclusive"]},
22
+ "claimStrength": {"enum": ["static-trace", "lab-reproduction", "observed-in-telemetry", "advisory-match", "reported-only"]},
23
+ "location": {"type": "string", "minLength": 1, "description": "file:line, dependency path, asset ID, or exercise step ID."},
24
+ "invariant": {"type": "string", "minLength": 1},
25
+ "observed": {"type": "string", "minLength": 1},
26
+ "impact": {"type": "string", "minLength": 1},
27
+ "preconditions": {"type": "string"},
28
+ "evidenceRefs": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
29
+ "remediation": {"type": "string", "minLength": 1},
30
+ "regressionCheck": {"type": "string", "minLength": 1},
31
+ "mappings": {
32
+ "type": "array",
33
+ "items": {
34
+ "type": "object",
35
+ "additionalProperties": false,
36
+ "required": ["framework", "version", "id"],
37
+ "properties": {
38
+ "framework": {"enum": ["CWE", "OWASP-ASVS", "OWASP-Top10", "ATTACK", "D3FEND"]},
39
+ "version": {"type": "string", "minLength": 1},
40
+ "id": {"type": "string", "minLength": 1},
41
+ "name": {"type": "string"}
42
+ }
43
+ }
44
+ }
45
+ }
46
+ }
@@ -0,0 +1,26 @@
1
+ # Routing
2
+
3
+ | Mode or intent | Skill and use |
4
+ | --- | --- |
5
+ | Project path, scan, audit, source or configuration review | Audit, read-only |
6
+ | Red, attack surface review | Red, supplied records only |
7
+ | Blue, logs, hunting, or incident | Blue for offline triage |
8
+ | Purple or detection validation | Purple for recorded observations |
9
+ | Simulate, generate events, or replay | Simulate for offline fixtures |
10
+ | Verify | Audit for a source fix, Purple for detection retest |
11
+ | Intel | Audit for supplied advisory review |
12
+ | Report | Summarize supplied records with their evidence IDs and limits |
13
+ | Help | Explain the modes and available skills |
14
+
15
+ The routing helper accepts a normalized mode. To route natural language, inspect
16
+ the requested action and artifact first. For ambiguous verification, use Audit
17
+ unless the evidence describes a defensive exercise. Use `--evidence exercise`
18
+ for that case. Report when source artifacts are missing. Current intelligence
19
+ requires an authorized source lookup and is outside the offline fallback.
20
+
21
+ Pass the names of specialists that the host exposes to this session as repeated
22
+ `--available` flags. Run `python3 scripts/route.py help` for the contract.
23
+ An installed specialist owns the work. For a missing specialist, use the
24
+ `installSelector` in the response with the project's Skills CLI source.
25
+ An entry-only install can provide a read-only inventory of supplied artifacts,
26
+ cite existing records, and help the user choose a workflow.