docs(reuse): establish reviewed NetKingdom security capabilities
Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a137ca-5c77-7a71-b9ae-23ad9b0b5684
This commit is contained in:
parent
de368271f6
commit
1427d268a0
2 changed files with 63 additions and 36 deletions
|
|
@ -1,8 +1,7 @@
|
|||
---
|
||||
id: capability.infotech.issue-tracking
|
||||
name: External Issue Tracker Connector
|
||||
summary: Backend-agnostic CLI/Python connector to Forgejo (and SQLite cache)
|
||||
with work-record UUID ↔ external issue mapping. Not the fleet work origin.
|
||||
name: External issue tracker connector
|
||||
summary: CLI and Python adapters for external issue systems.
|
||||
owner: issue-core
|
||||
status: draft
|
||||
domain: infotech
|
||||
|
|
@ -10,6 +9,9 @@ tags:
|
|||
- issue-tracking
|
||||
- connector
|
||||
- work-record
|
||||
- security
|
||||
- netkingdom
|
||||
- framework-reuse
|
||||
maturity:
|
||||
discovery:
|
||||
current: D4
|
||||
|
|
@ -21,8 +23,10 @@ maturity:
|
|||
current: A2
|
||||
target: A3
|
||||
confidence: high
|
||||
rationale: Python package + CLI (list/create/project/map) installable via pip;
|
||||
mapping store shipped; MCP not yet available.
|
||||
rationale: 'Source interface assessed 2026-10-14: CLI and Python adapters for
|
||||
external issue systems. Availability describes the delivery form, not production
|
||||
acceptance. Internal work originates in owner files; external projection is
|
||||
optional.'
|
||||
external_evidence:
|
||||
completeness:
|
||||
level: C2
|
||||
|
|
@ -32,7 +36,8 @@ external_evidence:
|
|||
- Forgejo + local SQLite backends
|
||||
- CLI with JSON output; project/map commands
|
||||
- work_record_uuid optional on TaskSpec
|
||||
- credential handling via env vars (FORGEJO_TOKEN preferred; GITEA_API_TOKEN deprecated alias; ISSUE_CORE_API_KEY)
|
||||
- credential handling via env vars (FORGEJO_TOKEN preferred; GITEA_API_TOKEN deprecated
|
||||
alias; ISSUE_CORE_API_KEY)
|
||||
broken_expectations: []
|
||||
out_of_scope_expectations:
|
||||
- Fleet task origin / intake promotion (work-record canon)
|
||||
|
|
@ -46,40 +51,60 @@ external_evidence:
|
|||
- no built-in issue locking beyond assignee+state
|
||||
- inward boundary sync not shipped
|
||||
discovery:
|
||||
intent: Project and operate on external issue trackers with a stable link to
|
||||
work-record UUIDs; never replace file-first work records as coordination substrate.
|
||||
intent: CLI and Python adapters for external issue systems
|
||||
includes:
|
||||
- unified Python API and CLI over Forgejo/SQLite issue operations
|
||||
- work_record_issue_map store + project/map/push-status
|
||||
- local offline cache and backend sync
|
||||
- credential handling via environment variables
|
||||
- CLI and Python adapters for external issue systems
|
||||
excludes:
|
||||
- originating workplans/tasks/intake
|
||||
- MCP server (planned)
|
||||
- multi-agent fleet board semantics on Forgejo
|
||||
- Internal work originates in owner files; external projection is optional
|
||||
assumptions: []
|
||||
use_cases: []
|
||||
use_cases:
|
||||
- 'U09: Maintainer observes posture, prioritizes findings, coordinates work and
|
||||
verifies outcomes'
|
||||
research_memos: []
|
||||
availability:
|
||||
current_level: A2
|
||||
target_level: A3
|
||||
current_artifacts:
|
||||
- Python package (`issue_core`)
|
||||
- '`issue` CLI (including project/map)'
|
||||
- README.md
|
||||
target_artifacts: []
|
||||
consumption_modes:
|
||||
- cli
|
||||
- library import
|
||||
- rest (optional `[api]` extra)
|
||||
- CLI
|
||||
- source
|
||||
relations:
|
||||
depends_on: []
|
||||
supports: []
|
||||
related_to:
|
||||
- capability.activity.event-coordinate
|
||||
- capability.security.iam-tooling-suite
|
||||
evidence:
|
||||
documentation:
|
||||
- INTENT.md
|
||||
- SCOPE.md
|
||||
- CAPABILITY-issue-tracking.yaml
|
||||
- docs/uuid-external-id-mapping.md
|
||||
- docs/boundary-sync-and-status-mapping.md
|
||||
- README.md
|
||||
consumer_guidance:
|
||||
recommended_for:
|
||||
- Maintainer observes posture, prioritizes findings, coordinates work and verifies
|
||||
outcomes
|
||||
not_recommended_for:
|
||||
- Internal work originates in owner files; external projection is optional
|
||||
known_limitations:
|
||||
- Internal work originates in owner files; external projection is optional
|
||||
- 2026-10-14 architecture review estimates operational maturity separately; a registry
|
||||
entry does not authorize execution or establish deployment.
|
||||
---
|
||||
|
||||
# External issue tracker connector
|
||||
|
||||
CLI and Python adapters for external issue systems.
|
||||
|
||||
## Reuse boundary
|
||||
|
||||
Internal work originates in owner files; external projection is optional.
|
||||
|
||||
## Supported use cases
|
||||
|
||||
- U09: Maintainer observes posture, prioritizes findings, coordinates work and verifies outcomes
|
||||
|
||||
## Evidence and integration
|
||||
|
||||
- [README.md](../../README.md)
|
||||
|
||||
Assessment: CUST-WP-0081, 2026-10-14. Relations identify interfaces to compose; they do not certify native integration. Existing external evidence levels are retained where present. New entries use conservative C1/R0 until consumer assessment exists.
|
||||
|
|
|
|||
|
|
@ -1,20 +1,22 @@
|
|||
version: 1
|
||||
updated: '2026-07-07'
|
||||
updated: '2026-10-14'
|
||||
domain: helix_forge
|
||||
capabilities:
|
||||
- id: capability.infotech.issue-tracking
|
||||
name: Universal Issue Tracking Coordination
|
||||
summary: Unified Python/CLI interface for issue tracking across Forgejo, GitHub, and GitLab, preventing
|
||||
direct platform API usage and credential sprawl for coordinating agents.
|
||||
vector: D4 / A2 / C2 / R1
|
||||
name: External issue tracker connector
|
||||
summary: CLI and Python adapters for external issue systems.
|
||||
domain: infotech
|
||||
status: draft
|
||||
owner: issue-core
|
||||
path: registry/capabilities/capability.infotech.issue-tracking.md
|
||||
tags:
|
||||
- issue-tracking
|
||||
- coordination
|
||||
- multi-platform
|
||||
- connector
|
||||
- work-record
|
||||
- security
|
||||
- netkingdom
|
||||
- framework-reuse
|
||||
vector: D4 / A2 / C2 / R1
|
||||
path: registry/capabilities/capability.infotech.issue-tracking.md
|
||||
consumption_modes:
|
||||
- cli
|
||||
- library import
|
||||
- CLI
|
||||
- source
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue